Jasik Designs 


343 Trenton Way Menlo Park, CA 94025 (415) 322-1386 


Feb 14, 1995 
Dear MacNosy/Debugger User, 
Enclosed is the latest release of The Debugger V2/95 and MacNosy and some accompanying notes on them. 
This release is a complete replacement for any previous version. 


For those of you who purchased The Debugger prior to November 1, 1994, this is you last free update. 
To receive updates and support in 1995, fill out the enclosed invoice and return it to me before May 1, 1995 
with authorization to bill your credit card or a check for $130 (payable to a US Bank). 
You can simplify my life by using e-mail to order your update subscription. 


The 2/14/95 version of The Debugger is now the “Reference version” or baseline for patches that 1 will be 
uploading to Internet and AppleLink. Send in your update fees so you get them. 


Tech Support for The Debugger is available via phone, or e-mail (macnosy Ojasik.com, ... ). 


Site (multiple copy) Licenses are available through Jasik Designs. Pricing 15 $225 per copy times the number 
of copies (programmers using the product) plus sales tax and $10 shipping. 

General 

Site Licensees - The CD-ROM contains a copy of this cover letter in Fullwrite format. 

Is your address label correct?? Is The Debugger/MacNosy meeting your needs, if not complain to me. 


The CD-ROM contains the long awaited Debugger Tutorial. Finally !! 


INIT notes 6: Other incompatibilities 

xDbgr_Startup MUST be placed in the Extensions folder on System 7. 

DiskLocker s (DiskLock, etc) appear to foul up ihe operation of The Debugger. 

MicroSoft Mail must load after The Debugger. 

Do NOT use any form for “Mr Bus Error”, 'evenBetterBus error”, etc., as it conflicts with The Debugger. 
After Dark users should be using version 2.0V or later, it should load after The Debugger. 

NOW utilities Startup Mgr - disable the options: 'protect screen from erasure’ & “display invisible INITs’ 
INIT ADB is an INIT to activate the “interrupt” (Command-power) key on the IIsi and Mac LC machines. It is 
in the folder: ‘Misc INITs & Source '. 

Retrospect Remote and CCNotify have been reported as incompatible with The Debugger. 

Think Reference - Please use Version 2.0.1 or later 

The Debugger is NOT compatible with Virtual Memory, RAM Doubler, ... 


Installation Procedure 

Copy the folder “2/14/95 Debugger files ” to your hard disk. 

As a backup, it also contains a copy of the folder as a Self Extracting Archive (.sea) file. 

If you have MPW, then 1 strongly suggest that you use the “Install Debugger” script . 

To manually install The Debugger, do the following: 

Copy the files in the “put files in System fldr” to your System folder. You must do this step. 

ROM .snt files are supplied for the PowerPC Macs's öz Macs with “067C” ROMs (Mac Ilcy/TIfx, ...). 
For other Macs will you can copy one from the folder “more ROM .snt files” into the “Dbgr/Nosy files” folder. 
Boot the Mac, and validate that the new version is operational. 

If you are using Version 3 of MacApp, then merge the IBS mods into the TBS folder. 

If you are using IBS, then reinstall it, using the IBS Install script. 


System Compatibility 
The Debugger and MacNosy have been tested on Systems 6.0.7, 7.0, 7.1, 7.1.2 and 7.5. 


Miscellaneous Notes 
* You may now change command key equivalents in The Debugger via the ‘ -Menu ° command in the dai file. 


See the documentation in ROM.dsi for details. Now you can close windows with Cmd-W '! 
ә You may need to use Set Dbgr Dir if you are playing with System 7.5 


New Features and Fixes, etc. (see the “Change History” file for a complete list) 


The file “hange Summary - 2/14/95” contains a summary of changes since the last update. 
The "change History” file contains a complete list of changes in chronological order. 


This version of the product is compatible with the upcoming PCI Bus Macs. 
Y ou will have to use Nosy to build a ROM .snt from scratch. 


e Cmd Key. Plus flag - If FrontWindow is Read. only then 'Cmd key’ is added to any Key press except e 
and period. i.e. you can step by pressing the comma key when a code window is frontmost. 


Fixed the PPC Watchpoint command so it is reasonable reliable. 


e add ?stack(fba,stk_top,is_PPC) command to dump an arbitrary stack 

if stk top = О then stk top := fba + 0С00, 

is PPC = 1 for stack that starts with PPC stack frames. 
MacApp 3.1 Object Inspector - Apple has included my mods into MacApp 3.1 and later versions. 
Nosy does not know about PEF (Power Executable Format) libraries, but YADP does. 


PPCTraceEnabler goes in Extensions on Power Macs Only. 
Itis a bug fix version of the ProcessManagerSuport Library supplied by Apple. 


ә Source level debugging of ASLM (Apple Shared Library Mgr) V1.1 libraries is supported. 
The INST! Bkpt flag has no effect, but you may set breakpoints in a .dsi file. 
You can debug Multi-seg Libraries. If the resource type to be debugged is NOT z code, 
then SYM file name must be of the form 'LibraryName.rrrr.SYM' where rrrr is the Resource type. 
ASLM Tasks are deleted when all segments are unloaded. 
e add DBG. SLM flag so you can conveniently turn debugging of ASLM code ON/OFF 


Known Problems 
e The text drawing routines put garbage on the user's screen when using Step Continuous. 
e When doing a Shutdown on some PowerBook 170's one gets a spurious BusError in The Debugger. 
* Using MMU protection with programs built with Model FAR causes spurious errors, see DTN #7. 
* Using the Think C Debugger in combination with The Debugger causes programs to stop at the 
end of The Debugger”s paich to  LoadSeg as die TC Debugger sets LoadTrap (byte at $12D). 
e The Debugger does not work with System 7 VM 
e Do not try to use a Syquest with the R45 INIT as a boot disk, The Debugger vvill screvv up. 


Future Directions 


At present, Nosy needs a bit of work to it so that it Knows about the PovverPC and Code Fragments, etc. 
Another thing 1 have been thinking about is to try and “hide” Nosy (or its function) so that The Debugger 
executes it on an as necessary basis vvhen there is a crash or unresolved names in the stack cravvl window, etc. 
I hope this will solve the problem of The Debugger not recognizing Macsbug names, etc. 


There are many features that are available for 68K debugging that are still not available for PowerPC debugging. 
Memory Watch for the PowerPC works and will be extended so that it is like MMU Protection on the 030 Macs. 


Another area which L expect to pay more attention to this year is error checking, which includes extending 
Discipline to the PowerPC Library calls. 


OpenDoc and SOM are coming, and I have to do something about displaying SOM Objects after Apple comes 
up with an API for it. 


Shows I will Attend - I will be at the Apple WWDC in May. 


If you did not receive notice of this mailing via an e-mail message, 


then I do NOT have your e-mail address. 
Please send it to me so I can check/update my database. 


Sincerely, 


Steve Jasik Internet: macnosy O jasik.com Compuserve ID: 76004,2067 AppleLink: D1037 


10/12/95 Jasik Debugger Notes - October 12, 1995 
To all Jasik Debugger users: 


** The files in this folder/disk are -replacement- versions 
of "The Debugger and Nosyll, ... 
The files in this folder have NOT been tested extensively, 
and as such they -MAY- introduce bugs or break existing features. 


* To take advantage of the new features, please copy 
-ALL- the files in the folder " to Dbgr/Nosy files (10/12) 
into the folder 'Dbgr/Nosy files on your Hard Disk. 


You may wish to backup your ROM.dsi file as | introduced a new flag: 
'Load_Sys_Lib_Sym_Into' 
Which controls the automatic loading of PowerPC Symbol info 
tor System Libraries. 


tak kik 


General 
*** Object Inspector for PowerPlant V1.2 *"" 
Is available in this archive AND on my WEB site. 
** Debugger Manual in Adobe Acobat Format *** 
Is available in this archive AND on my WEB site. 


** 7500/8500/9500 bug alert *** 
Apple put a nasty regression the 7.5.2(1.1) System that ships with the 
above Macs. The failure mode is that the SP register (ri on the PPC) 
is incorrect after stepping over an instruction in my Debugger 
that changes it. 
A few of you have stumbled upon it. 
| put some special code in my Debugger to search for this bug and 
change the offending instruction in the System Library to the correct one. 
Apple will fix this bug in some future release of the system 
later this fall. 


" System 7.5 upd 2.0 - s/ bug alert *** 
They blew it on Sounds at INIT time again, and 
you will have to use "Set Dbgr. Directory 
to point xDbgr Startup to the location of "The Debugger 
OR you can just wait for së, 


*** Speeding up MPW Builds *** 
Turn Filesharing OFF on your build Machine - 22 to 28 % 
OR Kill the "Finder" 
Turn the Spinning Cursor OFF via the Shell Variable - 5 to 10%: 
SET screenUpdateDelay 0 
you can turn it on by: SET screenUpdateDelay 1 
Compile multiple files via -ONE- compile directive: 
MrC fileA.c fileB.c ... fileZ.c options ... 
You can force "make" to do this by playing vvith options. 
** e-mail 
e-mail works about 98% of the time, not 100% , -SO-: 
Please include your name, address, Phone number 
and business affiliation in your message 
in the case that -MY- attempts to reply to you don't get through. 


Please DO NOT send me enclosures with the name 'to Steve' 
My download folder might fill up with Dup file names. 
Instead, how about 'from yourName' ?? 


** Connectix RAM Doubler & my Debugger DO NOT work together. 
De-install it and "re-bless" your System folder. 


** Connectix Speed Doubler & my Debugger work together. 
| am using it on my Power Macs and recommend it. 


Please note that with "Speed Doubler’ installed: 

a) You will not be able to use 'Performance Timing' 

b) If your program is 'lost' in an infinite loop in 68K code 
and you press Cmd-Power to enter any Debugger, 
then you may end up at an 'FE10 instruction generated 
by 'Speed Doubier and will -NOT- be able to get 
any information about where your program is. 
The only solution is to re-run the test case with-out 
Speed Doubler installed. 


**** | have had various problem reports from some of you, and in 
some cases the problems were traced to BUGGY Disk Drivers. 
SilverLining 5.6.x 'klobbers' location 8 (the 68K bus Error vector), 

which is totally un-acceptable. 
The APS Drivers do wierd things at INIT time. 
I recomend that you switch over to the FWB Drivers, and 
purchase a copy of the FWB Hard Disk TookKit so as to avoid 
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such problems in the future (which are difficult to diagnose). 
** Recommended versions of the Mac OS: 


9500 - 7.5.2(1.1) Avail from Apple call 800-769-2775 x5617 
I strongly suggest that you update to "1.1 version of the system. 


8500 & 7500 - The System that comes with it ( 7.5.2(1.1) ) is fine. 


All Other Macs - we have been running "7.5 upd2.0-s6' as 
shipped to developers on the "Sept Developer Seed" CD-ROM 
and it appears to be stable and eminately usable. 


** 9500/8500/7500 Alert *** 


In general, this version of The Debugger is compatable vvith 

the new PCI Bus Macintoshs. Changes have been made to the 

cursor handling and the VVatchpoint commands, etc. 

BUT: 

1) You need to make a new ROM/CODE.snt for these Macs from 'scratch' 
Please use the latest version of Nosyll (6/19/95 or later) to do it. 


2) Using Cmd-Power to enter the Debugger will hang the machine 
if you are using the 1.0 version of System 7.5.2 that was 
shipped with the 1st batch of 9500's. 

To avoid this problem, updgrade to *7.5.2(1.1) 


3) PCI Bus Macs 8 2 monitors appears to work in ALL cases, but 
Split screen may work best if in 'Monitors you configure the 
the boot screen and Menu Bar screen to be DIFFERENT monitors 


** If you are getting the message 'BufPtr < SP" (from xDbgr_Startup) 
with System 7.5.x then you can try patching the 'boot,3 resource 
with program 'boot_rsrc_Patcher which will automatically apply a 
patch to the 'System 7.5 Update' file or 'System' file as necessary 
so "The Debugger’ has more space available at Boot time. 


To fix the problem in 7.5.x: 
‘Option copy" the file "System 7.5 Update to the Desktop and re-boot 
Run 'boot_rsrc_Patcher' and select "System 7.5 Update' (closed copy) 
Move it back into the System folder. 
Re-Boot 


** Notes on the 'Low Memory Changed' message 


The DebuggerlNIT supplied by Metrowerks ( > 6/10/95) and Jasik get along. 
DebuggerlNIT changes locations 18, 1C, 20, 24, ... & 90 
Do NOT repair tnem. 


When you flip the triangle in a MW project window, Apple's 
Native QuickDraw 'Klobbers' location $10 
The bug may be fixed in the next release ( 7.5 upd x.0 ??) 


The SilverLining 5.6.x Disk driver "Klobbers" location 8, 
please replace it vvith "FVVB" Disk Drivers. 


** Miscellaneous features of interest: 


* Files:Create Log File" command for QA Testers, etc to save 
program state in a window which you can save to a file. 
Try it and you will see what it does. 


* Add "Vievv As" as a Popup-Menu when 'Cmd-Option-MouseDown' (II-click) 
OR as a click on the "Triangle" in the Title of 'Type@address' windows. 


User may configure the types in the PopUp menu via the .dsi command: 
=X followed by one or more lines with typeNames (seperated by Commas) 


TO use the 'View As' command you may: 
0) Click in the 'triangle' in the Title bar of a 'Type@address'window. 


1) Hilight a 'Type@address'’ expression (hex address, etc) in ANY window 
(except code) and '[I-click to get a PopUp Menu of choices to 'cast 
the expression. İt will open up a new window displaying the data 
in the format you selected. 

Try it. 

2) If the cursor is in the Title bar of a type. Фппп" or unstructured asm 
window etc, then 'Tl-click' to get a PopUp Menu of choices 
and it will reformat that window. When changing from TTT@nnn to @nnn, 
the code will remember TTT. 


3) If you click on a Name in a code window you will get a 
pop menu with the following: Procedure or Variable . 
This was done for those of you who complained that they could 
never remember which command to use (cmd-D , Cmd-W, Cmd-space, ei) 
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***** Fixes/Changes 10/9/95 to 10/12/95 
Dbgr 

fix - problems with Cursor on PCI Macs with 2 Monitors 

fix - don't send the AppleEvent to run Nosy if Load Sys Lib Sym Info if OFF 


in ROM.dsi 
fix - remove System patches are different, ... message as it was confusing 


Nosy 

fix - Alert user if more than 255 CODE segs, and only process 1st 255. 

fix - misc bugs in disasm of Pef - "QD GX' 8 "VVorldScript Power É' 

fix - explore all procs that have TVectors 

fix - In Global Data, use prefiks: DN nn = Ptr to Variable, DIV = Ptr to T Vector 
fix - in PEF if proc Len » 32K then split the proc up 

fix - 'Nosy Status' dialog so it displays the Object we are processing 
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**** Fixes/Changes 9/13/95 to 10/9/95 “***" 


xDbgr. Startup 
fix - swap scrn is default, do NOT lose split screen setting 


Both 
fix - treat type Ary Name[] from MW as 'Ary_Name:ARRAY[0:100] OF type’ 


fix - list mXspr instructions as mf/mt'spr' ri 
v "Set Source Path’ - add a GetFile Dialog to interactively select it. 
fix - when saving a ReadOnly window, clear the ReadOnly status 


Dbgr 

* Procedural Disassembly of PPC System Libraries is enabled by 
the flag: Load Sys Lib Sym İnfo. 
Auto Load PPC System Library .snt files when there is a reference to 
an address in a "System Context’ CFM Library or the user does a 
Cmd-D on an address in one of the libraries. 

* Display '*CurMap" in the '-Task and File İnfo" window. 

* Triangle where Zoom box is activates the Vievv-As PopUp Menu 

* Speed up Screen Swap on PPC by going native 

* Cmd-D on 'nnn', 'cOnnn', É - display as PPC if in a CFM lib 
allow Cmd-D on 'rd@nnn' & display proc if a single RD 


fix - display of Trap calls on Exit when Bkpt at trap call 
fix - suppress ‘can't find source path" msg for CodeWarrior Lib path 
fix - option didn't get back to user when native _GNE call 


fix - Apple Regression in 7.5.2(1.1) Apple ProcessMgrSupport 'sfvr 
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failure was incorrect Stack Ptr after stepping in PDC mode. 
Install code in Dbgr to fix it. 
fix - update "-Dbgr Status-" window after an '=G' command 
fix - revise CFM Notify Proc handling, allow main Appl with Exports 
fix - .dsi command processing - save selection prior to executing 
so an undo will erase any error and reselect the text 
fix - *pQ(expr)' blew up if expr was an un-mapped address 
fix - add warning that Modern Mem Mgr should be -ON-. 
fix - []-G displayed wrong zone name when MMM & Process Mgr's zone 
fix - Handle typed as '^Ptr' caused 2 opt-spaces & field could not be modified 
fix - PPC steplnst emulator - didn't setup FPSCH - got rounding errs on 8100/100 
Nosy 
* make creating a ROM/CODE.snt file less painful, especially for PCI Macs 
* Disassemble PEF containers via selecting 'cfrg', DataFork, or 
resorces containing PEF code fragments. 
* Accept AppleEvents, Auto-Build PPC System Info when requested to 
by "The Debugger’ - '.snt' files are saved in "System Info A". 


***** Fixes/Changes 8/6/95 to 9/13/95 ***** 


Both 
* process page up/down, home and End keys on the extended Keyboard 


* PPC disasm: addic x,y,0 -> mr x,y 8 show ASCII const's as comments 


fix - annotate trap calls where selector is CLH -(SP) 
fix - minor revisions to asm listing format to make Nosy/PEF more readable 


Nosy 
fix - "Cmd-Q" quits Nosy from the 4 button exit dialog 


* disasm PPC CFM code fragments in data fork or in a resource, ... 
* shift "Display:Globals Map" displays the "Global data declarations 
and Cmd-D on “Global data" displays the block 
* Add a fancy rsrc selection dialog 
fix - name substitution logic in DisCmd.p 
fix - dead carets in non-Front windows in name replace command (Cmd-h) 
fix - .snt file, if no refs then clear rom ref & sys ref tbls 


--Nosy Notes-- 
Nosy now disassembles 'PEF containers' with PowerPC code in them. 


It does NOT work with for 'cfrg's with multiple containers (an odd case) 
The Debugger' will read the '.snt' file of a 'PEF' object 

You can also target the resultant '.snt' files in "The Debugger. 

For the PEF stuff, this is an 'alpha' release as it is NOT feature complete. 


Dbgr 

“ identify this as Ver 2.8.3 | 

* enhance 'Target Lib' command so can read '.snt files produced by Nosy PEF disasm 

fix - Steplnto MixedModeMagic - didn't work for stack based selectors 

fix - Go Until PPC was broken 

fix - shift cmd-opt-Z ASCII = $FC , make Cmd key equiv work 

fix - Native Watchpoint was broken, it now works again 

fix - remove restriction that a CEM Llb must export a symbol to be debugged 

fix - code to use KCHR refed A5, incorrect as called at Interupt time 

fix - GrowZone Proc to release space from BufHndl if possible 

fix - cursor init logic so Screen swap might work on 2 Monitor PCI Bus Macs 
DisplayMgr is brain damaged, won't let me clone a GDevice 

fix - handling of -Values- so var with O offset works 

fix - revise Klobbered msg to be a bit clearer. 

fix - incorrect size calc for subranges with Upper Lim » 127 

fix - Perf timing wasn't working on the PCI bus Macs 
Note: - Perf Timing & Speed Doubler don't get along 


fix - remove extra screen swaps when processing a .sym file 


xDbgr Startup 
fix - swap scrn is default & accept Escape key to cancel 
fix - problems with APS drivers - add extra idiot msg 


***** Fixes/Changes 7/24/95 to 8/6/95 “**"" 


xDbgr Startup 

fix - check that name is: "The Debugger’ & is on Boot Partition 

fix - improve NO space error msg & suggest using boot rsrc Patcher" to fix. 
boot rsrc. Patcher 

* new program to patch the boot,3 resource of System 7.5 & later 


Dbgr 
* identify this as Ver 2.8.2 
fix - incorrectly setting is Case Sensitive flag for Pascal programs 
fix - option caused a BusErr on the 9500 picked up wrong _WNE addr 
fix - make -Local Values- always come up as Dynamic 
fix - find Hblk - no error checking for addrs in ROM Rsrc map sub-heap 
fix - modify getSuperClassID so "class tree’ display works for MacApp 3.3.1 
fix - screwup in System 7.5-s2 that caused _GetResource(MBDF) to fail 
when Speed Doubler was in. 
* dsi files - =Open allow: fileName,CLOSE to close an Opened .dsi window 
fix - no check for Mod Mem Mgr Dialog in System 7.5.2 & later 
Nosy 


fix - disassemble Metrowerks programs properly - still bugs in this area 
fix - recognize data biks that start with LINK A6 inst and iteratively 
explore them 


Both 
fix - AutoScrolling when Mouse is dragged outside the VievvRect 


* show the names of the selectors for a vvider variety of traps in the 
assembly, -"Stack State-" and the '-Trap/User Call- windows. 
Cmd-D on ' Selector trap Name" wili display the code of the underlying trap 


ҝә Fixes/Changes 6/19/95 - 7/24/95 əə 


Dbgr 
fix - modify getSuperClassID so ‘class tree" display vvorks for MacApp 3.3.1 
fix - INIT processing - let _CloseResFile delete the task as necessary 
fix - CloseResFile - don't blowup when Rsrc is Purged, just delete it 
fix - could NOT modify fields with NIL or bad ptrs/handles 
fix - rescrew invalid address checks - use Bus Error test for validity check 
The flag SLOT. MEM is no longer refed and is always valid. 
fix - deflect PEntryFromPSN (_OSDispatch) calls (PowerTalk Mail Server) 
fix - PPC entry didn't check Low Mem if PC was Invalid 
fix - incorrect identification of subheaps in Heap displays 
fix - screwup in PPC disasm of abs addrs with bl $-$123456 
fix - improve names in Stk crawl - 
it ON PPC & addr in Sys heap, then look for CFM Lib name 
display nearest exported proc name or ' $4000, ".sym.snt" was getting a spurious 
read SST err «6 
* NO more MMM Memorial Dialog Box on PCI Macs as they don't use the Exception 
Handler 
fix - add new selector for CoverTest 
* if 1st char of a DebugSir is 'À' (opt-?) then write Log file to 
'System folder' & resume execution 
fix - Go Until so that it works over a Native call on PowerMacs 
* display the ASCII equivalent of Longint values in'-Values- windows 
and Hex equiv of Integer, add sanity check to arrays with variable Upper Bounds 
* When can't find a source path, copy it to "-Notes-" window 
* Enable Jump Tracing for PowerPC Macs, use the PPC emulator to 
collect the info. INcrease n frames to 6 for OpenDoc/AppleScript 
fix - Dbgr didn't get along with head patch to _SetCursor in 7.5.2-s2 
fix - Reassign flags to they most frequent ones are 1st in list 
Add Shovv Alt Fmt to control display of ASCII equiv of HLongint, ... 
CoverText 
* Add sanity error check to see if Len(blocks) in xSYM = Len Execuable Seg 
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Feb 96 Jasik CD ROM Release Notes 


Feb 26, 1996 
Dear MacNosy/Debugger User, 


Enclosed is the latest release of The Debugger V2/96 and MacNosy and some notes on them. 


This release is a complete replacement for any previous version. 


For those of you who purchased The Debugger prior to November 1, 1995, this is you last free update. 
To receive updates and support in 1996, fill out the enclosed invoice and return it to me before May 1, 1996 
with authorization to bill your credit card or a check for $130 (payable to a US Bank). 

You can simplify my life by ordering your Debugger update subseriptions via e-mail, 


Last year, 1 posted most of my updates on the Internet and will continue to do so this year. 
i.e. I should have an (internet) e-mail address for you on file. 


The 2/24/96 version of The Debugger is now the “Reference version” or baseline for patches that I will be 
uploading to İnternet. Send in your update fees so you get them. 


Tech Support for The Debugger is available via phone, or e-mail ( macnosy @jasik.com ). 


Site (multiple copy) Licenses are available through Jasik Designs. The pricing is $225 per copy times the 
number of copies (programmers using the product) Plus sales tax and $10 shipping. 
Site Licensees - This letter did not make it onto the CD-ROM, but is available on my WEB site. 


Future Directions 
For me the big push this year will be to get my Debugger running on Copeland. 
You can help by sending in your update subscription fees ASAP. 


New or Changed 

In addition to the Hypercard Debugger Tutorial, I have added a New Features '96' Tutorial. 

Exclusive - The CD-ROM contains a copy of “The PowerPCTM Compiler Writers Guide" 

in ETML format courtesy of IBM. For those of you who are not compiler writers, chapter 5 contains some 
neat coding tricks. I and a number of Macintosh developers/Apple employees contributed to the book. It will 
be available in bookstores later this year. An errata sheet for the manual is on IBM's web page. 

Changed - I moved all the documentation over to Adobe Acrobat™ format. HTML versions will be available 
later this spring. The reference section of The Debugger manual was revised to bring it up to date. 


Feature Changes in 95 
1995 was a year of many changes for Nosy/The Debugger, compatibility with the PCI Macs headed the list. 
A complete list of the feature changes is in the file: “Feature Changes - 95” . 
Some of the more notable changes are: 
Nosy: 
New front end resource selection dialog making it easier to use. 
Disassembles PowerPC code and CFM containers. 
Disassembles Metrowerks 68K applications (funny jump table). 
Creating a ROM/CODE.snt file is less painful 
The Debugger 
Soft MMU (heap centric bounds checking) for PPC programs. 
Enable Jump Tracing for PowerPC Macs. 
Update Bkpt & mmU sections of '.dsi' file when a task terminates (not compatible with "det close"). 
If missing or wrong "ROM/CODE.snt file, then delete it and call NosyII to make one. 
Automatically debug PowerPC resources/CFM containers (OpenDoc Libraries) 
Add 'Create Log File' command for QA Testers, etc to save program state 
Add View As" Command as a PopupMenu in type @addr windows 90 as Cmd-opt-click 
Enhance PPC disassembly to show structure offsets, ... 
Speed up Screen Swap on PPC by going native 
Auto Load PPC System Library .snt files when there is a reference to an address in a 
'System Context' CFM Library or one does a Cmd-D on an addr in one of the libraries. 
Display of SOM Objects for OpenDoc users 
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Future Directions 
For me the big push this year will be to get my Debugger running on Copeland. 
You can help by sending in your update subscription fees ASAP. 


New or Changed 

In addition to the Hypercard Debugger Tutorial, I have added a New Features ‘96° Tutorial. 
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in HTML format courtesy of IBM. For those of you who are not compiler writers, chapter 5 contains some 
neat coding tricks. I and a number of Macintosh developers/Apple employees contributed to the book. It will 
be available in bookstores later this year. An errata sheet for the manual is on IBM”s web page. 

Changed -1 moved all the documentation over to Adobe AcrobatTM format. HTML versions will be available 
later this spring. The reference section of The Debugger manual was revised to bring it up to date. 


Feature Changes in 95 
1995 was a year of many changes for Nosy/The Debugger, compatibility with the PCI Macs headed the list. 
A complete list of the feature changes is in the file: “Feature Changes - 95”. 
Some of the more notable changes are: 
Nosy: 
New front end resource selection dialog making it easier to use. 
Disassembles PowerPC code and CFM containers. 
Disassembles Metrowerks 68K applications (funny jump table). 
Creating a ROM/CODE.snt file is less painful 
The Debugger 
Soft MMU (heap centric bounds checking) for PPC programs. 
Enable Jump Tracing for PowerPC Macs. 
Update Bkpt & mmU sections of '.dsi' file when a task terminates (not compatible with *dsi close"). 
If missing or wrong 'ROM/CODE.snt' file, then delete it and call NosyII to make one. 
Automatically debug PowerPC resources/CFM containers (OpenDoc Libraries) 
Add 'Create Log File' command for QA Testers, etc to save program state 
Add 'View As" Command as a PopupMenu in type Gaddr windows % as Cmd-opt-click 
Enhance PPC disassembly to show structure offsets, ... 
Speed up Screen Swap on PPC by going native 
Auto Load PPC System Library .snt files when there is a reference to an address in a 
'System Context' CFM Library or one does a Cmd-D on an addr in one of the libraries. 
Display of SOM Objects for OpenDoc users 
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343 Trenton Way Menlo Park, CA 94025 (415) 322-1386 
October 1, 1994 


- Important Note-- 


I mail out updates to registered users every 3 to 5 months. 

In between mailing I create patch files that apply to the 

last mailed out version of The Debugger (9/30/94 in this case) 
which include bug fixes and feature changes. 


These updates are sent to registered users via e-mail 
and in the case of new users placed on the distribution disks. 


The 9/30/94 version of The Debugger 'escaped' with a few bugs in it, 
and I strongly suggest that you install the enclosed patch 
as per the below instructions. 


The file “mm dd Dbgr Patch’ updates “The Debugger’. 


After you have unpacked the file: “9/30/94 Debugger .sea” 
on your hard disk, you can install the patch: 


A) Open up the folder 'Dbgr/Nosy files' and | 
change the name of "The Debugger' to: '9/30/94 Debugger 


B) Dbi-click on the UpdateMaker file ‘mm dd Dbgr Patch’ 


C) Select the file '9/30/94 Debugger' and click in the OK box to create 
a new version of "The Debugger’ (in the 'Dbgr/Nosy Dies folder). 
Note that the INIT ‘xDbgr Startup” which Launches ‘The Debugger’ 
always looks for a file named “The Debugger’ . 


You may verify that you are running the newer version 
of The Debugger by checking the 4th line of the '-Notes- 
window when you re-boot with The Debugger installed. 


It should read: 
USR SG = nnnn The Debugger - ... mm/dd/94 
Notes: 


On AppleLink, the path to my patch files is: 
Developer Support: Developer talk: Debugger discussion: 


On Internet: 


ncftp ftp.netcom.com (use ftp if your system doesn't have ncftp) 
са /pub/macnosy 
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October 1, 1994 


--Important Note-- 


I mail out updates to registered users every 3 to 5 months. 

In between mailing I create patch files that apply to the 

last mailed out version of The Debugger (9/30/94 in this case) 
which include bug fixes and feature changes. 


These updates are sent to registered users via e-mail 
and in the case of new users placed on the distribution disks. 


The 9/30/94 version of The Debugger 'escaped' with a few bugs in it, 
and I strongly suggest that you install the enclosed patch 
as per the below instructions. 


The file “mm dd Dbgr Patch’ updates “The Debugger’. 


After you have unpacked the file: '9/30/94 Debugger .sea' 
on your hard disk, you can install the patch: 


A) Open up the folder 'Dbgr/Nosy files' and | 
change the name of "The Debugger' to: '9/30/94 Debugger 


B) Dbl-click on the UpdateMaker file “mm dd Dbgr Patch 


C) Select the file '9/30/94 Debugger' and click in the OK box to create 
a new version of 'The Debugger' (in the 'Dbgr/Nosy files' folder). 


Note that the INIT 'xDbgr Startup' which Launches 'The Debugger' 
always looks for a file named “The Debugger’ . 


You may verify that you are running the newer version 
of The Debugger by checking the 4th line of the '-Notes-' 
window when you re-boot with The Debugger installed. 


It should read: 
USR SG » nnnn The Debugger - ... mm 4 
Notes: 


On AppleLink, the path to my patch files is: 
Developer Support: Developer talk: Debugger discussion: 


On Internet: 


ncftp ftp.netcom.com (use ftp if your system doesn't have ncitp) 
cd /pub/macnosy 


Jasik Designs 


343 Trenton Way Menlo Park, CA 94025 (415) 322-1386 


Oct 16, 1995 
Dear MacNosy User, 


This year I installed an ISDN (high speed) connection to the 
Internet and have been posting updates to "The Debugger 
and MacNosy to my WEB/FTP site (http: / /www.jasik.com). 
This has proved to be less of a hassle for me and has allowed 
me to post updates to my product on a monthly basis 


You are getting this letter and the enclosed disk because: 


I do NOT have a valid e-mail address for you in my 
database. 


Please note that next year, I may refuse to 

renew your Debugger/Nosy subscription if you still do 
NOT have a valid e-mail address. 

I know that the above may sound a bit harsh, but at present 
about 9306 of my users have e-mail addresses, and Apple, 
MicroSoft, ... are moving to on-line services for support. 
Note that Apple will be terminating AppleLink this fall. 

L suggest you consider joining eWorld, AOL, CompuServe 

or in Japan, NiftyServe or such. 


Now about the floppy disk: 


The file 10 12 Notes" describes the changes, new features, ... 


The folder to Dbgr/Nosy files (10/12)' contains replacements 
for NosyII, The Debugger, ... 
Copy the contents of it to your 'Dbgr/Nosy files' folder. 


I also included a copy of The Debugger manual in Adobe 
Acrobat format and some other goodies. 


Happy Debugging, 


Store Jaak 


Steve Jasik e-mail: macnosy@jasik.com 
WWW: http://www.jasik.com 


Jasik Designs 


343 Trenton Way Menlo Park, CA 94025 (415) 322-1386 
March 1, 1995 


--Important Note-- 


1) eee Wonders of Hypercard "II. 


Those of you who run the Debugger Tutorial on monitors smaller than 

1152 x 872 ( 20", 21") should note that Hypercrud will reposition the main 
window to the center of the screen. 

As the position of the movie window, ... is determined from the position of 
the main window, this will cause the Movie window to be partially off screen. 
You can minimize or avoid this problem by dragging the Main Hypercard 
window to the upper left corner of the monitor before you play any movies. 


2) I mail out updates to registered users every 3 to 5 months. 

In between mailing I create patch files that apply to the reference or base 
version of The Debugger (2/14/95 in this case) which includes bug fixes 
and new features. 


These updates are sent to registered users via e-mail 

and in the case of new users placed on the distribution disks. 10 / ] 2/ 95 and 
You can install the enclosed patch as per the below instructions. later patchs 
The file “mm dd Dbgr Patch' updates The Debugger’. available on 
After you have copied the folder: ‘2/14/95 Debugger files’ my web site 


to your hard disk, you can install the patch: 


As of August 95, the patch mechanism broke down as the size of the 
patch files approached the size as the 'stuffed' programs. 

The floppy disk that comes with my Debugger now contains a folder 
named: "to Dbgr/Nosy files (mm/dd)' R 

After doing a basic install of "The Debugger", copy the contents of that 
folder into the folder "bor /Nosy files ' and you have installed the 
latest update. 


In The Debugger, the second line of the '-Notes-' window should be: 


USR SG = nnnn The Debugger V2.8.6... 10/12/95 

or a later date 

N uar Ra E, KA de iate ин "T MEET A “a səs. | 
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The path to my patch files on Internet is: 
WWW Home Page & files: http://www.jasik.com 
Use Netscape to download the latest Patches. 
You may also use Fetch or Anarchie with the URL: 
ftp: / /www.jasik.com/ /sjasik/ 
Default format for Files at the FTP site is 'MacBinary IT 





,Oct 12th Jasik Update News 


From: macnosy@jasik.com (Steve Jasik} 
Subject: Oct 12th Jasik Update News 


To all Jasik Debugger users, 


I don't like to do mailings to the entire group more frequently 
than once a month, but almost everything that could go wrong with 
an e-mailing went wrong last Monday (Oct 9th). 


1) I didn't use BCC (Blind Carbon Copy) to send the messages and 
everyone with a ccMail gateway returned my message back as the 
list of names was too long. :-( 


2) Given my past sucess in uploading archives, I pushed the limit 
to 1.5Meg and some of you could NOT download it successfully. 


3) There were some minor bugs that a few of you discovered, so 
I tweeked Nosy to remove a DebugStr my assistant left in, 
and in the meantime, I got a fix from Apple for the problem 
of the cursor not behaving correctly on 2 Monitor PCI Mac systems. 


50, here is the revised archive that has some fixes, is smaller, 
and finally you can get it via FTP. 


de ik ade ək ək h ИН аф 3 k ip ök ök ik ok ik 

A number of you asked me to send you q disk or to e-mail you 
the archive. 

---Lets start anew with this archive.--- 


+ 


i.e. - I am deleting your letters, ... 


If you can't download via Netscape, or using FTP, then send me 


an e-mail message, and I will e-mail or snail mail it to you. 
* $ £ £ ** * xxx 


The password for the files is: "free the PPC ROM" 
in honor the the changes 
introduced in this version 


The 10/12 patchs are in 2 places: 
1) you get them the "old" way via Netscape (80ök as an .sea.hqx file). 


2) FTP to 'www.jasik.com' , directory = '/sjasik' and it is the only 
file in the Directory (18 12 Jasik Mods.sea) at 550K. 


In Anarchie, 


the URL is: "ftp: //www.jasik.com//sjasik/10. 12 Jasik Mods.sea' 
The file is formatted as: ‘MacBinary II' 


IN both cases, 
expand the archive, 


open up the folder: ' to Dbgr/Nosy files (10/123" 
Select All, 


and copy the files into YOUR 'Dbgr/Nosy files' folder. 


The file '10 12 Notes' describes the changes, 


Steve 


PS: I tested out both the FTP and Netscape Access to the files. 
ON my ISDN line, Anarchie downloaded the files at 72KB per second ! 


sg 









com (Steve Jasik) 





Printed for macnosy @jasik 


» Det 12th Jasik Update News 
Last minute stuff: 
Bad 01 Jokes: 


Nov that 0J is free, he is thinking about starting a Limosine service. 
The motto would be: 'we get you there on time, with at least an hour to kill' 


0J's e-mail address: slash, slash, backslash, escape 


Serious stuff: 


The Newer Accelerator for the 8500 and 9500 is available. 
I have been using it and running my 9500 at 164 Mhz for the 
last 3 weeks without any ill effects. 


A few days ago one of my users at Adobe Seattle sent me an e-mail 
that my Debugger wasn't working on his 9500/120 
but was doing fine on a neighbor's 9500. 


We had some discussions, he opened up his machine, 
reseated everything, and wrote me the following: 


= 


Subject: OUCH!!!! 


Well, I re-seated the cards (and Processor card) and it started working! 


Surprise, surprise. I'm still sending a flame to Apple about this. That 
connector has to be redesigned. 
<<<<<<< 


This is the first series of Macintosh's where this problem has come 
up with any frequency. 


Most annoying !! 


— ——— 
: 


i Printed for macnosy @jasik.com (Steve Jasik) 





Jasik Designs 


343 Trenton Way Menlo Park, CA 94025 (415) 322-1386 


Oct 1, 1994 


Dear Mac II Nosy/Debugger User, 
Enclosed is the latest release of The Debugger V2/94 and MacNosy and some accompanying notes on them. 
This release is a complete replacement for any previous version. 


The 9/30/94 version of The Debugger is now the “Reference version” or baseline for patches that I will be 
uploading to AppleLink and Internet. 

Tech Support for is available via phone, Applelink (D1037), or Internet (macnosy (? netcom.com). 

Please do NOT send messages from Internet to my Applelink address as Apple charges 50 cents per message. 


Site (multiple copy) Licenses are available through Jasik Designs. The pricing is $225 per copy times the 
number of copies (programmers using the product) Plus sales tax and $10 shipping. 


General 
Site Licensees - The floppy contains a stuffed copy of this cover letter in MS Word 4 format. 
Is your address label correct?? Is The Debugger/MacNosy meeting your needs, if not complain to me. 


INIT notes & Other incompatibilities 

xDbgr. Startup MUST be placed in the Extensions folder on System 7. 

DPI on the Fly - move to it to Extensions and make an Alias to it for use as a Control Panel. 

DiskLocker's (DiskLock, etc) appear to foul up the operation of The Debugger. 

MicroSoft Mail must load after The Debugger. 

Do NOT use any form for “Mr Bus Error”, “evenBetterBus error”, etc., as it conflicts with The Debugger. 
After Dark users should be using version 2.0V or later, it should load after The Debugger. 

NOW utilities Startup Mgr - disable the options: “protect screen from erasure’ öz “display invisible INITs” 
INIT ADB is an INIT to activate the ‘interrupt? (Command-povver) key on the Isi and Mac LC machines. It is 
in the folder: Misc INITS & Source'. 

Retrospect Remote and CCNotify have been reported as incompatible with The Debugger. 


Installation Procedure 

This update is shipped as a Self Extracting Archive (.sea) file. Double click on it to unpack the files. 

If you have MPW, then I strongly suggest that you use the “Install Debugger’ script. 

To manually install The Debugger, do the following: 

Copy the files in the “put files in System fldr” to your System folder. You must do this step. 

ROM .snt files are supplied for the PowerPC Macs”s öz Macs with “067C” ROMs (Mac Ilci/Iifx, ...). 
For other Macs will you have to create one. You must do this for AV and PowerBook 5xx Macintoshes. 


Boot the mac, and validate that the new version is operational. 
If you are using Version 3 of MacApp, then merge the IBS mods into the IBS folder. 
If you are using IBS, then reinstall it, using the IBS Install script. 


System Compatibility 
The Debugger and MacNosy have been tested on Systems 6.0.7, 7.1, 7.1.2 & 7.5. 
Remember to rename QuickDraw GX so it loads AFTER The Debugger. 


Miscellaneous Notes 
* You may now change command key equivalents in The Debugger via the “-Menu” command in the .dsi file. 
See the documentation in ROM dai for details. Now you can close windows with Cmd-W 11 


* Cmd-D - if a partial name (Class::mm) is typed in, then open up the procedure that contains that name 
OR list all proc names that 'match' in a window. 
For example, if txyz is a class, then entering “сху2::” into the Cmd-D box will list all its methods. 


ә You may need to use the APPL “Set Dbgr Directory” if you are using with System 7.5 


Miscellany 
The last mailing was over 6 months ago, and that is a bit long for both you and me. My apologies. 


The CD-ROM Tutorial is coming along. 1 expect to mail it out in Nov, no before Christmas. :-) 
All kidding aside, I want to get it out just as much as most of you want to see it. 
We now have 400 Meg of Hypercard, Premier, etc on hard disk and are putting the finishing touches on it, . 


lam considering distributing my product on CD-ROM and dropping most of the paper. 

Such a version of The Debugger would contain an electronic copy of the debugger manual, etc, along with a 
demo copy of FuliWrite 2.0 which it is written in. 

Comments from you are appreciated. 


Now that Newsweek has a page devoted to computer/internet related matters 1 would expect that most of you 
would have e-mail addresses. If I don't have your e-mail address please send it to me. 
I do have your e-mail address if you got a notice of this mailing on Oct 3rd via e-mail. 


Patch files will be placed in : 


AppleLink: Developer Support: Developer talk: Debugger discussion: 
Internet: neftp ftp.netcom.com ; cd /pub/macnosy 


Disk Contents 
“0/30 Feature Summary” (TEXT file) - a summary of the major external changes to The Debugger. 


‘READ ME !! - 9/30/94” (TEXT file) - a list of things NOT to do when installing/using The Debugger. 
Most of it discusses problems that I am having with Apple hardware and 
software that I haven't resolved. 


Please read it carefully as 1 have spent many hours on the phone with you discussing these problems. 


“ETO 15 & Jasik - Link V3.4d2' (TEXT file) - a short note for MPW users. 
. Note that an upcoming version of Metrowerks will support the “3.3” SYM file format. 


PowerPC Notes (MS Word) - some short notes on PowerPC debugging with The Debugger. 


System 7.5 Sucks More ! (TEXT) - My response to the T-shirt (System 7.5 Sucks Less) which an Apple 
programmer was wearing at the Apple WWDC 1994. 
9/30/94 Debugger.sea - A Self Extracting Archive containing the new release of The Debugger öz Nosy. 
It contains the following files of interest: 
Changes 3/16/94 to 9/30 - unedited notes of all the changes to The Debugger, ... in the last 6 months. 
Misc Nosy Files - 9/94 - Used to be called the “Blue disk” An electronic copy of the Debugger Tech Notes 
are hiding inside it. 
NEW Debugger Scripts - scripts to display thread Manager Queues, .. 
Discipline Stuff - contains a Double Dispose Example - run it once to familiarize yourself with my error msg. 
9/30/94 Debugger files - The “Install Debugger (MPW)’ script is hiding in here. 
I could have moved it up a level, but that would take away from the fun of a good scavenger hunt. 
New Human Interface Features - some comments 


As I mentioned in the *9/30 Feature Summary” 1 am not completely happy with the implementation of the direct 
memory change in the different windows, I am also having second thoughts on the use of the Function Keys to 
implement one key debugger commands. Another possibility is to note that most of the windows in The 
Debugger are read-only and hence I could allow one to enter commands without having to press the command 
key when one of those windows is frontmost. It is trivial to implement and you can expect to see some variant 
of it in the near future. 


PowerPC Notes - Sept 30th 1994 


Learning about the PowerPC 


I can display info about Power Macs, but 1 am NOT in the business of developing reference materials. 
The PowerPC Macs have a very different architecture from the 68K Macs. 
The runtime environment of the PowerPC Macs is derived from IBM s AIX OS. 


To get started, buy the "Macintosh with powerPC Starter Kit" from APDA (R0563LL/A) for about $40.00 . 
This is essential. The kit contains the Motorola/IBM reference manual for the 601 CPU. 


Also consider buying the 'Programmer's Introduction to RISC & PowerPC" a self paced mini-course for $150 


(R0172LL/A). 
If you or your company will spring for it, consider attending one of Apple's Developer University courses. 


The Debugger vs Povrer Macintosh (as of 9/30/94) 


The Debugger is capable of debugging Povver Mac (Native mode) programs. 

When you enter The Debugger, the format of the display in the registers window is dependent on the mode 
the machine was in when the exception was taken. If the machine was in Native mode, then you will get a 
display of the PowerPC registers, else you will get the classic 68K register display. 


Features not yet implemented for native programs are: 


Proc Entry/Exit Trace 

Trap Discipline 

Trap Intercept & Trap Entry Trace 

Transparent debugging of Executable resources. (use "Target Lib' as described below) 

Intelligent step into for mixed mode calls. 

Jump Tracing may never be available for Native programs 

MMU Protection may never be available for Native programs | 
Structured disassembly of Native code in the ROMs. (Kludges are in Nosy for display in The Debugger) 
Nosy doesn't know how to disassemble the PowerPC (CFM) libraries, and IBS hasn't been touched. 


Some of these deficiencies will be rectified in the next few months, 
along with getting the Debugger to work with VM. 


Feature that are now working include: 


Single statement source stepping. 

Performance Timing 

Memory Watch 

CoverTest knows how to do Code coverage of Native programs, 
Features added for PowerPC debugging 


PowerPC disassembly with 'training wheels' and emulation trace 
The format of a line in a structured assembly window is: 
addr: result label opcode operands ; meaning of instruction 
The result field may hold the following: the result value of a load or register to register instruction, 
or "saddress" , the effective address of a store instruction, or 'except n' if execution of the instruction will 
cause an exception. 
In the Tables menu, two new items have been added: "СЕМ..." and ‘Target Lib...” . 
The CFM item will display a list of all the loaded CFM libraries, or of all the entry points in a given library, 
or it will find the address of a given symbol. 


The 'Target Lib’ command allows you to specify a library to be symbolically debugged. 

You must have an 'xS YM! file for the library. To use the command, select it once, dismiss the dialog, 
hilight the name of the library you want to debug, and then select the '.xS YM' file from the Standard 
file dialog. 


You may reference the pseudo variables: ?LR, ?CR, ?XER, ?CTR in expressions. 


PowerPC Notes - Sept 30th 1994 


Learning about the PowerPC 


1 can display info about Power Macs, but 1 am NOT in the business of developing reference materials. 
The PowerPC Macs have a very different architecture from the 68K Macs. 
The runtime environment of the PowerPC Macs is derived from IBM's AIX OS. 


To get started, buy the 'Macintosh with powerPC Starter Kit” from APDA (ROS63LL/A) for about $40.00 . 
This is essential. The kit contains the Motorola/IBM reference manual for the 601 CPU. 


Also consider buying the 'Programmer's Introduction to RISC öz PowerPC” a self paced mini-course for $150 


(R0172LL/A). 
If you or your company will spring for it, consider attending one of Apple's Developer University courses. 


The Debugger vs Power Macintosh (as of 9/30/94) 


The Debugger is capable of debugging Power Mac (Native mode) programs. 

When you enter The Debugger, the format of the display in the registers window is dependent on the mode 
the machine was in when the exception was taken. If the machine was in Native mode, then you will get a 
display of the PowerPC registers, else you will get the classic 68K register display. 


Features not yet implemented for native programs are: 


Proc Entry/Exit Trace 

Trap Discipline 

Trap Intercept & Trap Entry Trace 

Transparent debugging of Executable resources. (use Target Lib' as described below) 

Intelligent step into for mixed mode calls. 

Jump Tracing may never be available for Native programs 

MMU Protection may never be available for Native programs d 
Structured disassembly of Native code in the ROMs. (Kludges are in Nosy for display in The Debugger) 
Nosy doesn't know how to disassemble the PowerPC (CFM) libraries, and IBS hasn't been touched. 


Some of these deficiencies will be rectified in the next few months, 
along with getting the Debugger to work with VM. 


Feature that are now working include: 


Single statement source stepping. 

Performance Timing 

Memory Watch 

CoverTest knows how to do Code coverage of Native programs, 
Features added for PowerPC debugging 


PowerPC disassembly with “training wheels' and emulation trace 
The format of a line in a structured assembly window is: 
addr: result label opcode operands : meaning of instruction 
The result field may hold the following: the result value of a load or register to register instruction, 
or '>address' , the effective address of a store instruction, or 'except n' if execution of the instruction will 
cause an exception. 
In the Tables menu, two new items have been added: "СЕМ..." and "Target Lib...” . 
The CFM item will display a list of all the loaded CFM libraries, or of all the entry points in a given library, 
or it will find the address of a given symbol. 


The Target Lib’ command allows you to specify a library to be symbolically debugged. 
You must have an 'xSYM' file for the library. To use the command, select it once, dismiss the dialog, 
hilight the name of the library you want to debug, and then select the 'XSYM' file from the Standard 


file dialog. 
You may reference the pseudo variables: ?LR, ?CR, ?XER, ?CTR in expressions. 


Invoice March 18, 1994 


From: Jasik Designs, 343 Trenton Way, Menlo Park, CA 94025 
(415) 322-1386 


To: paste your New Address 
mailing label 
here 
For: 
Quantity Item Unit price Total 
Debugger/Nosy Updates in 1994 $130 


Additional Licenses for Univ Debugger 9225 


8.2 % Sales Tax for California Residents 








Total 7. 
If you are paying by Visa/MC then fill out: 
Card Name: VISA _ MasterCard 
Card Number: _ oa o Expires: /. 
Name of Cardholder (Print) 
Your Signature: 
Phone (in case of problems) _ _ AppleLink 8 


O;ders paid by credit card may be sent to me via AppleLInk 
(D 1037) or CompuServe (76004,2067) , etc. 

Please include your card number, expiration date, name, and 
authorization to debit your card by the stated amount. 


Payment must accompany this form !!! 
DO NOT send me ə Purchase Order !! 


Orders paid for by Visa/MasterCard will snow up on your Visa/MC 
statement as a charge from Jasik Designs. 
Paper receipts will be supplied only upon request. 


You are being billed for update fees for your copies of 
The Debugger V2 & Nosy because my records show that you 
purchased/updated your copies of it prior to Dec. 1, 1993. 


If you feel that I am in error, then please submit a copy of canceled 
checks or other proof of purchase. 


Jasik Designs 


343 Trenton Way Menlo Park, CA 94025 (415) 322-1386 


March 17, 1994 


Dear Mac II Nosy/Debugger User, 
Enclosed is the latest release of The Debugger V2/94 and MacNosy and some accompanying notes on them. 
This release is (one) complete, and (two) a replacement for any previous version. 


For those of you who purchased The Debugger prior to December 1, 1993, this is you last free update. 
To receive updates and support in 1994, fill out the enclosed invoice and return it to me before June 1, 1994 
with authorization to bill your credit card or a check for $130 (payable to a US Bank). 
You can simplify my life by using e-mail to send in your update fees. 
The 3/16/94 version of The Debugger is now the *Reference version” for patches that I will be uploading to 
AppleLink and Internet. Send in your update fees so you get them. 


Tech Support for The Debugger is available via phone, Applelink (D1037), or CompuServe (70277,776). 


Site (multiple copy) Licenses are available through Jasik Designs. The pricing is $225 per copy times the 
number of copies (programmers using the product) Plus sales tax and $10 shipping. 

General 

Site Licensees - The floppy contains a stuffed copy of this cover letter in MS Word 4 format. 

Is your address label correct?? Is The Debugger/MacNosy meeting your needs, if not complain to me. 


INIT notes Other incompatibilities 

xDbgr. Startup MUST be placed in the Extensions folder on System 7. 

DPI on the Fly - move to it to Extensions and make an Alias to it for use as a Control Panel. 

DiskLocker's (DiskLock, etc) appear to foul up the operation of The Debugger. 

MicroSoft Mail must load after The Debugger. 

Do NOT use any form for “Mr Bus Error”, “evenBetterBus error”, etc., as it conflicts with The Debugger. 
After Dark users should be using version 2.0V or later, it should load after The Debugger. 

NOW utilities Startup Mgr - disable the options: ‘protect screen from erasure’ 8 “display invisible INITs’ 
INIT_ADB is an INIT to activate the “interrupt” (Command-power) key on the IIsi and Mac LC machines. İt is 
in the folder: ‘Misc INITS & Source”. 

Retrospect R mote and CCNotify have been reported as incompatible with The Debugger. 


Installation Procedure 

This update 1s shipped as a Self Extracting Archive (.sea) file. Double click on it to unpack the files. 

If you have MPW, then I strongly suggest that you use the “Install Debugger” script . 

To manually install The Debugger, do the following: 

Copy the files in the “put files in System fldr” to your System folder. You must do this step. 

Copy or create a ROM .snt for your machine (default in Dbgr/Nosy files is for a $067C ROM (Mac IIci/THfx, ...) 
You must do this for AV and Power Macintoshes. 

Boot the mac, and validate that the new version is operational. 

If you are using Version 3 of MacApp, then merge the IBS mods into the IBS folder. 

If you are using IBS, then reinstall it, using the IBS Install script. 


System Compatibility 
The Debugger and MacNosy have been tested on Systems 6.0.5, 6.0.7, 7.0 , 7.0.1, 7.1, & 7.1.2. 


Miscellaneous Notes 
* You may now change command key equivalents in The Debugger via the “-xenu” command in the dai file. 
See the documentation in ROM.dsi for details. Now you can close windows with Cmd-W !! 


s Cmd-D - if a partial name (Class::mm) is typed in, then open up the procedure that contains that name 
OR list all proc names that 'match' in a window. 
For example, if Txyz is a class, then entering "cxyz : :” into the Cmd-D box will list all its methods. 


ә You may need to use Set Dbgr Dir if you are playing with System 7.5 


PowePC Notes - March 17th 1994 


Learning about the PowerPC 

I can display info about Power Macs, but I am NOT in the business of developing reference materials. 

The PowerPC Macs have a very different architecture from the 68K Macs. 

The runtime environment of the PowerPC Macs is derived from IBM's AIX OS. 

To get started, buy the 'Macintosh with powerPC Starter Kit" from APDA (R0563LL/A) for about $40.00 . 
This is essential. The kit contains the Motorola/IBM reference manual for the 601 CPU. 


Also consider buying the "Programmer s Introduction to RISC & PowerPC" a self paced mini-course for $150 


(RO172LL/A). mE 
If you or your company will spring for it, consider attending one of Apple's Developer University courses. 


The Debugger vs Power Macintosh (as of 3/16/94) 

The Debugger is capable of debugging Power Mac (Native mode) programs. 

When you enter The Debugger, the format of the display in the registers window is dependent on the mode 
the machine was in when the exception was taken. If the machine was in Native mode, then you will get a 
display of the PowerPC registers, else you will get the classic 68K register display. 


At present, not all features of the 68K debugger have been implemented in native mode. 
Features not implemented for native programs include: 


Single statement source stepping (it is at the instruction level). Using Go Until PC is a bit faster. 
Performance Timing 

Intelligent step into for mixed mode calls. 

Memory Watch and Proc Entry/Exit Trace 

Trap Discipline 

Trap Intercept & Trap Entry Trace 

Transparent debugging of Executable resources. 

Structured disassembly of Native code in the ROMs. 

Jump Tracing may never be available for Native programs 

MMU Protection may never be available for Native programs 


In addition, CoverTest does not know how to do Code coverage of Native programs, 
Nosy doesn' know how to disassemble the PowerPC (CFM) libraries, and IBS hasn't been touched. 


Hopefully many of these deficiencies will be rectified in the next few months, 
along with getting the Debugger to work with VM. 


Features added for PowerPC debugging 


PowerPC disassembly with 'training wheels' and emulation trace 
The format of a line in a structured assembly window is: 
addr: result label opcode operands - meaning of instruction 
The result field may hold the following: the result value of a load or register to register instruction, 
or '>address' , the effective address of a store instruction, or ‘except n' if execution of the instruction will 
cause an exception. 


In the Tables menu, two new items have been added: "СЕМ..." and "Target Lib...’ . 
The CFM item will display a list of all the loaded CFM libraries, or of all the entry points in a given library, 
or it will find the address of a given symbol. 


The 'Target Lib' command allows you to specify a library to be symbolically debugged. 

You must have an 'xS YM: file for the library. To use the command, select it once, dismiss the dialog, 
hilight the name of the library you want to debug, and then select the '.xSYM file from the Standard 
file dialog. 


You may reference the pseudo variables: ?LR, ?CR, ?XER, ?CTR in expressions. 


Jasik Designs 


343 Trenton Way Menlo Park, CA 94025 (415) 322-1386 


December 30, 1993 
Dear Mac II Nosy/Debugger User, 


Enclosed is the latest release of the Universal Version of The Debugger V2/93 and MacNosy and some 
accompanying notes on them. This release contains numerous bug fixes and new features. 
Major feature enhancements included are MacApp 3.181 support and PowerPC Native mode debugging. 


Tech Support for The Debugger is available via phone, Applelink (D1037), CompuServe or Internet. 


Site (multiple copy) Licenses are available through Jasik Designs. The pricing is $225 per copy times the 
number of copies (programmers using the product) Plus sales tax and $10 shipping. 


Metrowerks Codewarrior is here, and unlike Symantec C, it produces an Apple standard .SYM file. 
You get FULL source level debugging with Metrowerks. I strongly encourage you to give it a try. 


General 
Site Licensees - The floppy contains a stuffed copy of this cover letter in MS Word 4 format. 


Is your address label correct?? Is The Debugger/MacNosy meeting your needs, if not complain to me. 


I have includes a number of “goodies” on the disk, including Swatch (a Heap Watcher by Joe Holt of Adobe), an 
electronic copy of gray manual in text format, and some Discipline examples. 


INIT notes & Other incompatibilities 

xDbgr. Startup MUST be placed in the Extensions folder on System 7. 

DPI on the Fly - move to it to Extensions and make an Alias to it for use as a Control Panel. 
DiskLocker's (DiskLock, etc) appear to foul up the operation ot The Debugger. 

MicroSoft Mail must load after The Debugger. 

Do NOT use any form for “Mr Bus Error”, “evenBetterBus error”, etc., as it conflicts with The Debugger. 
SuperBoomerang- use V3.01 or later as some of the 3.0 versions had bugs. 

After Dark users should be using version 2.0V or later, it should load after The Debugger. 

NOW utilities Startup Mgr - disable the options: “protect screen from erasure” & “display invisible INITs’ 
Retrospect Remote and CCNotify have been reported as incompatible with The Debugger. 

QuickKeys 3.0 appears to cause problems when Shutdown is selected from inside The Debugger. 
AOCE AppleMail V1.0 - the disk contains a patch file to make it compatable with The Debugger. 


Think C Reference V2 is incompatible with The Debugger, Use Version 2.0.1 which is compatible. 


Installation Procedure 
This update is shipped as a Self Extracting Archive (.sea) file. Double click on it to unpack the files. 
The Debugger is now shipped on one 1.4 Meg floppy. This is a complete release. 


If you have MPW, then I strongly suggest that you use the ‘Install Debugger’ script . 

To manually install The Debugger, do the following: 

Copy the files in the “put files in System fldr" to your System folder. You must do this step. 

Copy or create a ROM .snt for your machine (default in Dbgr/Nosy files is for a $067C ROM (Mac Do, 
Boot the mac, and validate that the new version is operational. 

If you are using Version 3 of MacApp, then merge the IBS mods into the IBS folder. 

If you are using IBS, then reinstall it, using the IBS Install script. 


I will distribute Patch files to this version of The Debugger via AppleLink. 
Make a copy of The Debugger (call it "12/30 Debugger’) to run the patcher against. 


System Compatibility 
The Debugger and MacNosy have been tested on Systems 6.0.5, 6.0.7, 7 D TOLL. 5 
Fixes to The Debugger this spring make it compatible with WorldScript П, QuickDraw GX, AOCE, etc. 


Jasik Designs 


343 Trenton Way Menlo Park, CA 94025 (415) 322-1386 


December 30, 1993 
Dear Mac II Nosy/Debugger User, 


Enclosed is the latest release of the Universal Version of The Debugger V2/93 and MacNosy and some 
accompanying notes on them. This release contains numerous bug fixes and nevv features. 
Major feature enhancements included are MacApp 3.181 support and PowerPC Native mode debugging. 


Tech Support for The Debugger is available via phone, Applelink (D1037), CompuServe or Internet. 


Site (multiple copy) Licenses are available through Jasik Designs. The pricing is $225 per copy times the 
number of copies (programmers using the product) Plus sales tax and $10 shipping. 


Metrowerks Codewarrior is here, and unlike Symantec C, it produces an Apple standard .SYM file. 
You get FULL source level debugging with Metrowerks. 1 strongly encourage you to give it a try. 


General 
Site Licensees - The floppy contains a stuffed copy of this cover letter in MS Word 4 format. 
Is your address label correct?? Is The Debugger/MacNosy meeting your needs, if not complain to me. 


I have includes a number of *goodies' on the disk, including Swatch (a Heap Watcher by Joe Holt of Adobe), an 
electronic copy of gray manual in text format, and some Discipline examples. 


INIT notes & Other incompatibilities 

xDbgr. Startup MUST be placed in the Extensions folder on System 7. 

DPI on the Fly - move to it to Extensions and make an Alias to it for use as a Control Panel. 
DiskLocker's (DiskLock, etc) appear to foul up the operation ot The Debugger. 

MicroSoft Mail must load after The Debugger. 

Do NOT use any form for “Mr Bus Error”, “evenBetterBus error”, etc., as it conflicts with The Debugger. 
SuperBoomerang- use V3.01 or later as some of the 3.0 versions had bugs. 

After Dark users should be using version 2.0V or later, it should load after The Debugger. 

NOW utilities Startup Mgr - disable the options: “protect screen from erasure' & 'display invisible INITS' 
Retrospect Remote and CCNotify have been reported as incompatible with The Debugger. 

QuickKeys 3.0 appears to cause problems when Shutdown is selected from inside The Debugger. 
AOCE AppleMail V1.0 - the disk contains a patch file to make it compatable with The Debugger. 


Think C Reference V2 is incompatible with The Debugger, Use Version 2.0.1 which is compatible. 


Installation Procedure 
This update is shipped as a Self Extracting Archive (.sea) file. Double click on it to unpack the files. 
The Debugger is now shipped on one 1.4 Meg floppy. This is a complete release. 


If you have MPW, then I strongly suggest that you use the *Install Debugger" script . 

To manually install The Debugger, do the following: 

Copy the files in the “put files in System Hdr to your System folder. You must do this step. 

Copy or create a ROM .snt for your machine (default in Dbgr/Nosy files is for a $067C ROM (Mac Ilci...) 
Boot the mac, and validate that the new version is operational. 

If you are using Version 3 of MacApp, then merge the IBS mods into the IBS folder. 

If you are using IBS, then reinstall it, using the IBS Install script. 


I will distribute Patch files to this version of The Debugger via AppleLink. 
Make a сору of The Debugger (call it "12/30 Debugger’) to run the patcher against. 


System Compatibility 
The Debugger and MacNosy have been tested on Systems 6.0.5, 6.0.7, 7.0, 7.0.1, 7.1, ... 
Fixes to The Debugger this spring make it compatible with WorldScript II, QuickDraw GX, AOCE, etc. 


Debugger Tech Note #11 


Parser Extensions & 'demds' 


N 8/93, Revised 12/93 





The basic expression language is described on pages 37 to 40 of the gray manual and summarized in the 
“D Help- file which is displayed when the Help command is selected in The Debugger. 

This tech note discusses additions to the expression language that are not in the gray manual. 

They make it useful for the writing of scripts which display the contents of tables, lists, etc. 


The AddMenu dei command + =Addmenu ) 


This .dsi file command lets you associate a Menu item in the "MacApp” Menu with a script. The Syntax is: 


=Addmenu 
'Menultem_Name'/CmdKey 
action clause lines 


To delete an AddMenu from the "MacApp" Menu one hiltes ONLY the —A and addmenu name lines. 
The file "Dbgr Scripts" contains some sample AddMenu scripts. 


The ?get value function 


When the ?get value function is executed from inside an AddMenu script it returns the hexidecimal 
value that the user entered, or was hilited in the front window. Its syntax is: 

Function ?get.Ualue('prompt-string'):Longint; | | | 
An example of it's use is: 7fba := ?get_Value('enter İst byte addr to dumpi}; — 
If no selection is present, then the user will be presented with a 2 line typein dialog box with the prompt 
string on the second line. If a selection is present, then it will be used as the value to be converted. 
Leading garbage ( 6, $, = ) in the string will be skipped over. The string is assume to be a hex number. 
If the user presses the Cancel button, then the script is terminated. | 


Output Re-direction 


Normally commands, write statements in 'action clauses', etc put their output at the end of the '-Notes- 
window. The ?ReDirect command lets one define an alternate window for such output. The syntax is: 


?ReDirect('uindouMane' (,Rppend) ): - If 'windowName' exists then bring it to the front, else create a 
window with a name 'windowName' . If the Append parameter is present, then output will be appended to 
the end of the text in the window, else the text will be deleted and the window drawn as empty the next 
time it is written to. 

?ReDirect; - re-directs output to the "-Notes-" window in Append mode. 


Note: Unlike MPW, The Debugger always redirects output to the end of text in the redirection window. 
Note: If the shift key is held down when an Addmenu is executed, then ?ReDirect( wName will 
always create a new window with the name 'wName nn" ( nn - 1, 2, ...). 


Array References 


You may reference the elements of a 1-dimensional array via the notation: ArName[subScript_expr] 
If ArName is a pointer to an Array, then one writes: ArName”[subScript_expr] and so on. 
The address is calculated as: 

AddrOf( ArName) + sizeOf Arname, element * (subScript expr - Lower bound) 


which is just what you would expect. For an example of it's use see the ‘Files’ script in 'Dbgr Scripts’. 
You can reference any of your global variables in your program during the execution of a script. 
The way to display an element of an array of Extended elements is: write(myArray[n]}:Extended) ; 
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Parser Extensions & 'demds' 


N 8/93, Revised 12/93 





The basic expression language is described on pages 37 to 40 of the gray manual and summarized in the 
-D Help- file which is displayed when the Help command is selected in The Debugger. 

This tech note discusses additions to the expression language that are not in the gray manual. 

They make it useful for the writing of scripts which display the contents of tables, lists, etc. 


The AddMenu dei command ( =Addmenu ) 


This .dsi file command lets you associate a Menu item in the "MacApp" Menu with a script. The Syntax is: 


=Addmenu 
'Henultem_Name'/CmdKey 
action clause lines 


To delete an AddMenu from the "MacApp" Menu one hiltes ONLY the =A and addmenu name lines. 
The file "Dbgr Scripts" contains some sample AddMenu scripts. 


The ?get_value function 


When the ?get_value function is executed from inside an AddMenu script it returns the hexidecimal 
value that the user entered, or was hilited in the front window. Its syntax is: 


Function ?get_Value('prompt_string'):Longint; | | 
An example of it's use is: ?fba := ?get_Value('enter İst byte addr to dump’); —— 


If no selection is present, then the user will be presented with a 2 line typein dialog box with the prompt 
string on the second line. If a selection is present, then it will be used as the value to be converted. 
Leading garbage ( О, 5, =) in the string will be skipped over. The string is assume to be a hex number. 
If the user presses the Cancel button, then the script is terminated. 


Output Re-direction 


Normally commands, write statements in 'action clauses', etc put their output at the end of the '-Notes-' 
window. The ?ReDirect command lets one define an alternate window for such output. The syntax is: 


>ReDirect('windouName* (,Rppend) ); - If 'windowName' exists then bring it to the front, else create a 
window with a name 'windowName' . If the Append parameter is present, then output will be appended to 
the end of the text in the window, else the text will be deleted and the window drawn as empty the next 
time it is written to. 

?ReDirect; - re-directs output to the '-Notes-' window in Append mode. 


Note: Unlike MPW, The Debugger always redirects output to the end of text in the redirection window. 
Note: If the shift key is held down when an Addmenu is executed, then ?ReDirect( wName) will 
always create a new window with the name 'wName nn’ (nn - 1, 2, ...). 


Array References 


You may reference the elements of a 1-dimensional array via the notation: ArName[subScript_expr ] 
If ArName is a pointer to an Array, then one writes: ArName”[subScript_expr] and so on. 
The address is calculated as: 

AddrOf(ArName) + sizeOf_Arname_element * (subScript_expr - Lower_bound) 


which is just what you would expect. For an example of it's use see the Tiles" script in 'Dbgr Scripts. 
You can reference any of your global variables in your program during the execution of a script. 
The way to display an element of an array of Extended elements is: write(myArray[n] :Extended), 


Jasik Designs 


343 Trenton Way Menlo Park, CA 94025 (415) 322-1386 


August 2, 1993 
Dear Mac II Nosy/Debugger User, 


Enclosed is the latest release of the Universal Version of The Debugger V2/93 and MacNosy and some 
accompanying notes on them. This release contains numerous bug fixes and new features. 


Tech Support for The Debugger is available via phone, Applelink (D1037), or CompuServe. 
I have also signed up to access Internet via “Netcom”, and will make appearances there later this summer 
after I figure out how to use the Unix (Yeech!) interface. My address is: macnosyünetcom.netcom.com. 


Site (multiple copy) Licenses are available through Jasik Designs. The pricing is $225 per copy times the 
number of copies (programmers using the product) Plus sales tax and $10 shipping. 

General 

Site Licensees - The floppy contains a stuffed copy of this cover letter in MS Word 4 format. 

Is your address label correct?? Is The Debugger/MacNosy meeting your needs, if not complain to me. 


This update is being shipped on a 1.4 Meg Floppy. 

If you don't have access to a Mac IIx or later Mac then I can send you the update on 800K floppies. 

I have includes a number of “goodies” on the disk, including Swatch (a Heap Watcher by Joe Holt of Adobe), 
an electronic copy of gray manual in text format, and some Discipline examples. 


Any updates to The Debugger over the next few months will be posted in the “Debugger Discussion" 
area on AppleLink as patches to the 8/1/93 version of The Debugger. 


INIT notes 6: Other incompatibilities 

xDbgr Startup MUST be placed in the Extensions folder on System 7. 

DPI on the Fly - move to it to Extensions and make an Alias to it for use as a Control Panel. 

DiskLocker's (DiskLock, etc) appear to foul up the operation of The Debugger. 

MicroSoft Mail must load after The Debugger. 

Do NOT use any form for “Mr Bus Error”, “evenBetterBus error”, etc., as it conflicts with The Debugger. 
SuperBoomerang- use V3.01 or later as some of the 3.0 versions had bugs. 

After Dark users should be using version 2.0V or later, it should load after The Debugger. 

NOW utilities Startup Mgr - disable the options: ‘protect screen from erasure’ & “display invisible INITs' 
INIT. ADB is an INIT to activate the “interrup” (Command-power) key on the Hsi and Mac LC machines. İt IS 
in the folder: ‘Misc INITs & Source’. 

Retrospect Remote and CCNotify have been reported as incompatible with The Debugger. 


Think C Reference V2 is incompatible with The Debugger, Use Version 2.0.1 which is compatible. 


Installation Procedure | 

This update is shipped as a Self Extracting Archive (.sea) file. Double click on it to unpack the files. 

If you have MPW, then I strongly suggest that you use the *Install Debugger" script . 

To manually install The Debugger, do the following: 

Copy the files in the "put files in System fldr" to your System folder. You must do this step. 

Copy or create a ROM .snt for your machine (default in Dbgr/Nosy files is for a $067C ROM (Mac IIci/IIfx, ...) 
Boot the mac, and validate that the new version is operational. 

If you are using Version 3 of MacApp, then merge the IBS mods into the IBS folder. 

If you are using IBS, then reinstall it, using the 185 Install script. 


System Compatibility 
The Debugger and MacNosy have been tested on Systems 6.0.5, 6.0.7, 7.0, 7.0.1, 7.1, ... 
Fixes to The Debugger this spring make it compatible with WorldScript II, QuickDraw GX, AOCE, etc. 


Jasik Discipline vs Apple code 
I fixed some spurious discipline errors in The Debugger only to find some fairly evil code emanating from 
Cupertino. Check out the Discipline Stuff” folder for a discussion of this and an interesting example. 


MPVV”s ILink vs The Debugger 
I will NOT be supporting the State (.N7) files produced by [Link which is part of ETO #10. 
I feel that IBS is still a superior solution, and urge you to give it a try if you haven't already. 


New Features and Fixes, etc. (see the “Change History” file for a complete list) 


The file “Change Summary- 3/27 to 8/2/93” contains a summary of changes since the last update. 
The “Change History” file contains a complete list of changes in chronological order. 
DTN #11 describes the changes to the parser, which include support for Macsbug ‘dcmds’. 


CoverTest - now works with ThC projects, the documentation has been revised. 
The Debugger will search the project for the names of Static functions, 
and name them 'fileNameSfuncName' or 'fileName$static п 15 source is not available. 


e Source level debugging of ASLM (Apple Shared Library Mgr) V1.1 libraries is supported. 
The INST1_Bkpt flag has no effect, but you may set breakpoints in a .dsi file. 
You can debug Multi-seg Libraries. If the resource type to be debugged is NOT = code, 
then SYM file name must be of the form 'LibraryName.rrrr.S YM' where rrrr is the Resource type. 
ASLM Tasks are deleted when all segments are unloaded. 
e add DBG SLM flag so you can conveniently turn debugging of ASLM code ON/OFF 


Known Problems 
e The text drawing routines put garbage on the user's screen when using Step Continuous. 
e When doing a Shutdown on some PowerBook 170”s one gets a spurious BusError in The Debugger. 
* Attempting to set a breakpoint at an address > 16Meg that is not in a task will not work. 
* Using MMU protection with programs built with Model FAR causes spurious errors, see DTN +7. 
* Using the Think C Debugger in combination with The Debugger causes programs to stop at the 
end of The Debugger's patch to LoadSeg as the TC Debugger sets LoadTrap (byte at $12D). 
e The Debugger does not work with System 7 VM 
* Do not try to use a Syquest with the R45 INIT as a boot disk, The Debugger will screw up. 
e The Debugger does not handle .S YM file info for arrays with variable bounds.emitted by LS Fortran. 


ROMinations 


Over the years Apple has produced a number of ROMs. Aspects of the ROM which are important to The 
Debugger are the base address of the ROM, which is in the low memory global ROMBase, and the version 
which is in the word at ROMBase+8. Apple has produced the following major versions of the ROM: 


Size ROM Id ent Used On 

64K M NO 128K & 512K Mac's - NOT supported by The Debugger 
128K 0075 BlueDisk Mac +, Mac Classic is really 128K ROM with resources 
256K 0178 BlueDisk Mac II, IIx, Псх, SE/30 

256K 0276 BlueDisk Mac SE 

256K 037A build Old Portable (Luggable) 

512K - 1Meg 067C Default* Mac Ilci, IIfx, PowerBooks, Quadras, etc 

2Meg 077D build Centris 660A V & Quadra 840AV (Tempest & Cyclone) 


The 067C ROM is one of the most popular ROMs. It is the first 32 bit clean ROM. | 

It implements System 6.0.4 in it. Previous Mac II ROMs are 32 bit dirty, and are poor choices for debugging, or 
use with an add-on accelerator board. 

The standard base address for the 067C ROM is $4080 0000. Some oddball Mac's like the IIsi and the LC use a 
base address of $40A0 0000, which mean that the supplied ROM .snt doesn't work. 


The 077D ROMs in the new Macs implement System 7.1 in the ROM, reducing the size of the patches required 
to run. The 077D ROMs will be the basis for most future Macs. 


68040 Notes 
The Jump trace bit does not work correctly in the 68040 CPU chips (Motorola screwed up). As a consequence, 
the "Trace Jumps' and “Proc Entry/Exit Trace” commands do NOT work on Macs with these CPUs. 


Future (Work in Progress) - PowerPC ` 

While many of you will have a fairly easy conversion over to the PowerPC Macs, I have quite a bit of work to 
do in order to get The Debugger to debug PowerPC programs in ‘Native’ mode. 

As part of the effort, I have to understand the hardware, the software, write new code for many of The Debugger 
features such as walking the stack, etc. I hope to have something available late this fall (by December ??). 
Given this fact, I suspect that MMU protection for 040”s will never happen. 


Sincerely, 


Steve Jasik AppleLink: D1037 Compuserve ID: 76004,2067 
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The basic expression language is described on pages 37 to 40 of the gray manual and summarized in the 
-D. Help- file which is displayed when the Help command is selected in The Debugger. 

This tech note discusses additions to the expression language that are not in the gray manual. 

They make it useful for the writing of scripts which display the contents of tables, lists, etc. 


Output Re-direction 


Normally commands, write statements in "action clauses’, etc put their output at the end of the '-Notes-' 
window. The ?ReDirect command lets one define an alternate window for such output. 

The syntax is: 

?ReDirect ('windowName' (,Append) ); - If 'windowName' exists then bring it to the front, else create a 
window with a name 'windowName' . If the Append parameter is present, then output will be appended to 
the end of the text in the window, else the text will be deleted and the window drawn as empty the next 
time it is written to. 

?ReDirect, - re-directs output to the Notes. window in Append mode. 


Note: Unlike MPW, The Debugger always redirects output to the end of text in the redirection window. 


Write Statement Extensions 


The syntax of a list in a write statement is: 

write list := List ele ( ,List ele } Dor more times. 

List ele := "string constant" | ?REC(TypeName, address) | expression ( :TypeName {:width} ] 
The extension 1s that vve can novv control the vvidth of the output field by specifying it. 

For example, write(?xx:HLongint:6); displays the value of the Debugger variable ?xx in a field of 6 
columns instead of the normal 10 columns blank, dollar-sign and 8 digits ). It does this by truncating the 
leading 4 columns from the output. 

This extension enables us to display tables in neat columnar format. 


Array References 


You may reference the elements of a 1-dimensional array via the notation: ArName [subScript_expr] 
If ArName is a pointer to an Array, then one writes: ArName” [subScript expr] and soon. 
The address is calculated as: 

AddrOf(ArName) + sizeOf, Arname element * (subScript expr - Lower bound) 


which is just what you would expect. For an example of it's use see the ‘Files’ script in Dbgr Scripts’. 
You can reference any of your global variables in your program during the execution of a script. 
The way to display an element of an array of Extended elements is: write (myArray[n] :Extended) ; 


While, Repeat-Until loops and CYCLE and LEAVE statements 


WHILE and REPEAT - UNTIL loops are implemented just as they are in Pascal. 
You may nest loops up to 8 levels deep. 

A CYCLE statement will cause a branch to the end of the current loop and a LEAVE 
statement will branch to the statement following the end of the loop. 


Dbgr Seripts" contains a number of examples of WHILE loops. FOR loops are not implemented. 


The ?UserC command 


The ?UserC command vvas created for those of you vvho vvant to dump more intricate structures then one can 
easily do vvith the expression language. An example is the symbol tabie of a compiler. 

The syntax of the command is: ?UserC (expression, ProcName); 

Expression will be evaluated and the 32-bit value passed to the procedure ProcName in your program. 

The output of printf statements from ProcName will be intercepted by The Debugger, buffered up and 
displayed in a window when the ?UserC command completes. 


printf and all the procedures it calls must be loaded when the command executes, else LoadSeg will be 
called and it will cause the value of the PC and some of the registers to change, which is NOT what you want. 


A Sample script that calls of ?UserC is: 
?Redirect ('SymTab Dump'); ?UserC(SymTab Ptr, dump symbol tbl) ; ?ReDirect; 


As always, the above line can be part of an action clause, or one can triple-click on the above line 
and press 'Shift-Cmd-[' (Shift-Calculate). 


Macsbug "demds" 

After extending the expression language and vvriting some sample scripts vvith it, 1 feel that there are very 
few 'dcmds' that are worth using. Two are 'Leaks', the Memory leak detector by Bob Johnson, which is 
available on the Apple Tool Chest Developer CD-ROM and the 'thing' dmcd which displays the loaded 
QuickTime components. 

Demds may be loaded at Debugger initialization time by adding the following lines to ROM.dsi: 

=2 ; Load Resident dcmd's 

file name of a resource file containing "dcmd" resources 


( you may specify multiple file names on separate lines). 
If you don't specify a full pathname, then the dcmd files should be in the "Nosy/Dber files’ folder. 


тасиа (аста name,'argument'); will execute a 'resident demd. 
2dcmd; will list all the resident dcmd's and their help prompts. 


Dcmds may also be loaded at any time and executed via the statement: 


?demd(demd name, "argument" ,pathname) ; 

I have only implemented a subset of the dcmd callbacks described in the Macsbug Reference and Debugging 
Guide so you are limited to passing only one argument to a dcmd. While the dcmd will be given an 
initialization call, it may not work properly in the case that you load the demd at other than Debugger 
initialization time. The Leaks dcmd must be loaded at Debugger Init time. 





ACI US ships Object Master™ Universal version 2.0, a source code editor and 
development tool. 


ACI US, Inc. is currently shipping Object Master" Universal version 2.0, an upgrade 
to its dynamic source code editor and development tool. The new version provides 
significant enhancements to facilitate the development of applications created in the 
MPW?, THINK C™, Symantec™ C++, and THINK Pascal™ environments. 


Object Master's Project window allows developers to specify which resources to 
include in a project. As files are added, Object Master parses them, creating a 
dictionary of component file information. The dictionary includes information such 
as definition and location ot all classes, methods, procedures, fields, and data types. 


Using the Browser window, developers can view the entire project through lists of 
procedures, functions, classes, methods, and fields. Developers can also access 
specific sections of code by selecting any method or procedure in the Browser 
window. Editing can be done in either the Browser window or the File window. 
When a function or method implementation changes, Object Master updates the 
header automatically, eliminating the need for double-editing. When the developer 
adds a new method to a class, Object Master automatically creates a skeletal 
implementation for it. 


Object Master's full-featured source code editor was written by programmers for 
programmers. The editor provides programming-specific features such as: 


Syntax checking: Object Master checks a file's syntax when it is added to the project 
or when the developer saves changes. Automated syntax checking reduces the need 
for frequent compiling. 


Function call template generation: Developers can use template calls generated 
automatically by Object Master to call any method or function. 


Custom formatting: When displaying a file from a supported language, Object 
Master color codes and stylizes text for easy identification. Developers can customize 
styles for each of the six language elements: procedures, keywords, compiler 
directives, syntax errors, disabled directives, and comments. 


ACI LS. inc. 10351 Bubb Road Cupertino, CA 95014 
Tel. 408 252 4444. Fax 1 408 252 0831. AppieLink DALL 


Automarkers: Markers created by Object Master for every procedure and function in 
a project can be used to quickly locate source code. Errors are indicated by markers 
which help users identify and access problematic code. | 


The Segment window lists all segments in the project and displavs the methods and 
procedures each segment contains. In this window, developers can easily resegment 
source code by dragging and dropping methods and procedures into segments. 


In the Class Tree window, Object Master graphically depicts a project's class and 
provides easy access to methods, procedures, and fields within the hierarchy. This 
window facilitates navigation by depicting the hierarchy of a project and displaying 
all methods and fields. Clicking methods and fields in this window allows users to 
display the selected routine for editing. 


With version 2.0, Object Master introduces over 150 new features and 
enhancements. Object Master Universal version 2.0 offers improved speed of 
operations. For example, parsing speed has increased two to three times in the new 
release. Another parser enhancement is its extended code support—the new version 
can parse C++ 3.0 code and, thanks to its support for macros, can even parse non- 
Macintosh code. For quick and uninterrupted parsing, parser errors are placed in an 
error list that is displayed when parsing is completed. 


With version 2.0, Object Master Universal offers users extended growth potential 
and expansion paths. The new version works seamlessly with MPW, THINK C, 
Symantec™ C++, and THINK Pascal, allowing users to create applications using 
multiple development environments. No additional modules are necessary— 
communication between Object Master and the development environments is 
performed via AppleEvents. Additionally, the new version continues to support 
procedural programming as well as object-oriented programming, offering users a 
smooth transition path from purely procedural programming to object-oriented 
programming. 


Other new features in Object Master Universal version 2.0 include modeless search 
dialogs, project history lists, filters for class/file displays, and support for Apple's 
SourceServer and AppleScript'*. The AppleScript support allows users to submit 
queries on the project, autor common tasks, and add custom menus. 
Object Master Universal surpa: iere source code editors by offering additional 
features that support users when uney need it most—during code development. 


To Order Object Master™ Universal, call us at (408) 252-4444 x252 


For more information or a demo diskette, call (408)252-4444 


Jasik Designs 


343 Trenton Way Menlo Park, CA 94025 (415) 322-1386 


March 17, 1993 


Dear Mac II Nosy/Debugger User, 
Enclosed is the latest release of the Universal Version of The Debugger V2/93 and MacNosy and some 
accompanying notes on them. This release contains numerous bug fixes and new features. 


For those of you who purchased The Debugger prior to December 1, 1992, this is you last free update. 
To receive updates and support in 1993, fill out the enclosed invoice and return it to me before May 1, 1993 
with authorization to bill your credit card or a check for $130 (payable to a US Bank). 


Tech Support for The Debugger is available via phone, Applelink (D1037), or CompuServe (70277,776). 
Site (multiple copy) Licenses are available through Jasik Designs. The pricing is $225 per copy times the 
number of copies (programmers using the product) Plus sales tax and $10 shipping. 

General | E 

Site Licensees - The floppy contains a stuffed copy of this cover letter in MS Word 4 format. 

Is your address label correct?? Is The Debugger/MacNosy meeting your needs, if not complain to me. 


68040 Notes | : | 
The Jump trace bit does not work correctly in the 68040 CPU chips (Motorola screwed up). As a consequence, 
the “Trace Jumps' and “Proc Entry/Exit Trace” commands do NOT work on Macs with these CPUs. 


INIT notes 

You may bypass most problems with INITs by loading The Debugger early. To do this, rename 

“xDbgr. Startup” to ‘!xDbgr_Startup’ or select it to load before any INITs, particularly NOW Utilities V4. 
This will also get around problems with WorldScript, CD-ROM VA, etc, etc. 

xDbgr Startup MUST be placed in the Extensions folder on System 7. 

DPI on the Fly - move to it to Extensions and make an Alias to it for use as a Control Panel. 

DiskLocker's (DiskLock, etc) appear to foul up the operation of The Debugger. 

MicroSoft Mail must load after The Debugger. 

Do NOT use any form for “Mr Bus Error”, “evenBetterBus error”, etc., as it conflicts with The Debugger. 
SuperBoomerang- use V3.01 or later as some of the 3.0 versions had bugs. 

After Dark users should be using version 2.0V or later, it should load after The Debug ger. 

NOW utilities Startup Mgr - disable the options: “protect screen from erasure” öz “display invisible INITs’ 
INIT ADB is an INIT to activate the 'interrupt' (Command-power) key on the IIsi and Mac LC machines. İt is 
in the folder: Misc INITs € Source. 


Installation Procedure 

This update is shipped as a Self Extracting Archive (.sea) file. Double click on it to unpack the files. 
The ROM/CODE.snt for the Mac IIci/IIfx,... was omitted, get a copy from an older release. 

If you have MPW, then I strongly suggest that you use the ‘Install Debugger” script . 

To manually install The Debugger, do the following: 

Copy the files in the “put files in System fldr” to your System folder. You must do this step. 

Copy or create a ROM .snt for your machine (default in Dbgr/Nosy files is for a 256K ROM Mac Il) 
Boot the mac, and validate that the new version is operational, 

If you are using Version 3 of MacApp, then merge the IBS mods into the IBS folder. 

If you are using IBS, then reinstall it, using the IBS. Install script. 


System Compatibility 

The Debugger and MacNosy have been tested on Systems 6.0.5, 6.0.7 7.0, 7.0.1, 7.1, & the System 7 TuneUp. 
For the Classic and LC you must build a ROM/CODE.snt file from scratch. I have also tested The Debugger on 
the Centris 610,Centris 650, Quadra 800 and PB 165c, and some unannounced machines. 


MPW's ILink vs The Debugger 

I will NOT be supporting the State (.NJ) files produced by ILink which is part of ETO #10. 

I feel that IBS is still a superior solution, and urge you to give it a try if you haven't already. 
This release of PatchLink contains bug fixes to make it work with big segments, big jump tables, 
and fixes the problem of lost “A“name” types. 

For your info, I have included some recent mail from AppleLink on the subject on the disk. 


Jasik Designs 


343 Trenton Way Menlo Park, CA 94025 (415) 322-1386 


July 27, 1992 
Dear Mac II Nosy/Debugger User, 


Enclosed is the latest release of the Universal Version of MacNosy and The Debugger V2/92, and some 
accompanying notes on them. This release contains numerous bug fixes and new features. 


Tech Support for The Debugger is available via phone, Applelink (D1037) or CompuServe. 


Site (multiple copy) Licenses are available through Jasik Designs. The pricing is $225 per copy times the 
number of copies (programmers using the product) plus sales tax and $20 shipping. 


68040 Notes 

The Jump trace bit does not work correctly in the 68040 CPU chips (Motorola screwed up), and as a 
consequence, the “Trace Jumps' and “Proc Entry/Exit Trace' commands do NOT work machines with these 
CPU's. Motorola DOES NOT intend to fix the problem. Because of this and the fact that MMU 
protection works better on the 68030 Macs (IIci, IIfx), they are still the best machines for debugging. 


INIT notes 

MicroSoft Mail must load after The Debugger. 

SuperBoomerang- use V3.01 or later as some of the 3.0 versions had bugs. 

After Dark users should be using version 2.0V or later, it should load after The Debugger. 

xDbgr Startup MUST be placed in the Extensions folder on System 7. 

NOW utilities Startup Mgr - disable the options: ‘protect screen from erasure’ öz “display invisible INITs’ 
INIT ADB is an INIT to activate the “interrupt” (Command-power) key on the IIsi and Mac LC machines. İt is 
in the folder: ‘Misc INITs & Source. 


Installation Procedure 

This update is shipped as a Self Extracting Archive (.sea) file. Double click on it to unpack the files. 
The ROM/CODE.snt for the Mac II /IIx/IIcx,... was omitted, get a copy from an older release. 
If you have MPW, then I strongly suggest that you use the “Install Debugger" script . 
To manually install The Debugger, do the following: 
Copy the files in the “put files in System fldr” to your System folder. You must do this step. 
Copy or create a ROM .snt for your machine (default in Dbgr/Nosy files is for a 512K ROM Mac Ilci/IIfx...) 
Boot the mac, and validate that the new version is operational. 
There are no significant changes to the MacApp of IBS mods in this release and you may omit changing them. 
If you are using Version 3 of MacApp, then merge the IBS mods into the IBS folder. 
If you are using IBS, then reinstall it, using the IBS. Install script. 
Svstem Compatibility 
The Debugger and MacNosy have been tested on Systems 6.0.5, 6.0.7 7.0 , 7.0.1, 7.1, & the System 7 TuneUp. 
For the Classic and LC you must build à ROM/CODE..snt file from scratch. 


Miscellaneous Notes 
e You may now change command key equivalents in The Debugger via the ‘=Menu’ command in the dai file, 
see the documentation in ROM.dsi for details. Now you can close windows with Cmd-W !! 


e Cmd-D - if a partial name (Class::mm) is typed in, then open up the procedure that contains that name 
OR list all proc names that 'match' in a window. 
For example, if Txyz is a class, then entering “txyz::” into the Cmd-D box will list all its methods. 


I have been successful in shipping patches to The Debugger to some you this spring via AppleLink, 

and will continue to do so this summer. Shortly after the disks were duplicated, I fixed a significant bug in 

SYM file type processing. The fix will be sent to users with AppleLink ID's only. I can NOT send binary files 
cross to Internet addresses. Send me your AppleLink ID if you haven't already done so. 


' & 
Patch files sent out this summer will use this version (7/23/92) as the base version. A 


Debugger Tech Notes (DTN”s) are on the floppy in MicroSoft Word 4 format along with a table of contents. 
DTN”s 0, 5, 6, 7 and 9 have been revised and DTN 10 on Performance timing is new. 


New Features and Fixes, etc (see the “Change History” file for a complete list) 


* CoverTest V.99.5 is included. A short user guide for it is in the “Dbgr Tech Notes” folder. 

* Add a ***** FREF so Nosy is System 7 'Drag and Drop" compatible 

° Add a Performance Timing command öz windows (see DTN #10 for details) 

¢ Shift-"Heap Scramble' scrambles the System Heap (no auto turnoff) 

* add ability read protect O page of memory in MMU Protection 

e add ability to use MMU Protection for MPVV Tools 

* Dbgr is configurable for Foreign keyboards etc in ResEdit using the 'Dcfg' resource 

* Heap display - move summary to front & display Detached Resources (file refnum = ‘<??>’) 

e add Dbgr flag Sgned Char Strs' to force "Array of char’ to be a string 

* Increase size of trap patch table from 512 to 768 

fix - MMU Prot on & Heap Scramble => spurrious BusErr s from temp buffer used by HS 

fix - Dbgr hung in VO System vvhen VVatchpoint tripped during a SCSI Read 

fix - to get along vvith V1.3 of RadiusVVare for their 040 accelerators 

fix - if Univ ROMs then skip NotifyMgr call in _SystemTask in Dbgr so we can debug them 

fix - to vvork vvith QuickDravv GX 

fix - undo 1/9/92 fix to processing of Local Yars that caused incorrect display of Pascal VAR params. 
Also add logic to delete dup displays of mem & reg values if both are the same 


Known Problems 

ə The text drawing routines put garbage on the user”s screen when using Step Continuous. 

e When doing a Shutdown on some PowerBook 170”s one gets a spurrious BusError in The Debugger. 

* Attempting to set a breakpoint at an address > 16Meg that is not in a task will not work. 

* Using MMU protection with programs built with Model FAR causes spurrious errors, move the CODE 
seg named '32-bit bootstrap' to the System heap to avoid them. Use the following Shell command: 
echo “change "CODE" (0"32-bit bootstrapd") to $$type ($$id,$$Attributesl64 );" d 

| rez -a -o myAPPL 


* MPW C outputs bad SYM info for enum declarations that contain refs to symbols previously defined 
in the enum ( enum (a,b, c2 alb); ). The Debugger may blowup during type processing. A fixed 
C compiler should be available by ETO #8 time. QuickTime users should fix Movies.h. 
* Using the Think C Debugger in combination with The Debugger causes programs to stop at the 
end of The Debugger's patch (о LoadSeg as the TC DEbugger sets LoadTrap (byte at $12D). 
e The MDEF distributed with IBS for use in the MPW Shell does not work with System 7. 
e The Debugger does not work with System 7 VM 
e Do not try and use a Syquest with the R45 INIT as a boot disk, The Debugger will screw up. 
* MMU protection does NOT work on Mac II's with the Dove Accelerator installed. 
* The Debugger does not handle .SYM file info for arrays with variable bounds.emitted by LS Fortran. 
* some very large programs have more than 65K global vars which exceeds the limit of the SYM file format. 
There are NO warning messages from the Linker or Debugger but garbage names in the Local Vars display. 





Future (Work in Progress) 
We will be working on the following features for the next release((October 1992): 


ə MMU Protection for Macs with 040 CPUs 


Shows I will Attend 
I will be at the Boston Macworld in August (at the Apple Tools expo). 


The Head Nose on CD-ROM/QuickTime 
Is in progress and will be done by this fall hopefully. 


Sincerely, 


.. 
"e 1 4 ` 
` + ud Ax 


Steve Jasik AppleLink: D1037 Compuserve ID: 76004,2067 ) 





Debugger Tech Note #10 


Performance Timing Analysis 





N July 92 


Control 


Information 

The Debugger now contains a timing facility that is accessible via the "Performance Timing ..." command in 
the Go menu. The facility monitors program execution and presents a histogram of where the program 15 
spending its time. The command will work on all Macs from the Mac H on; it has the following selections: 
1) Timing is OFF: 

You will be presented with a type-in dialog box and the '- Tasks & Files-" window. 

Type in the number of the task you want to monitor and press return. The task must be either an 

Application or MPW Tool. When you exit The Debugger, it starts a timer task that samples the program 

counter (PC) at regular intervals and builds a histogram of it in memory. 

When you next enter The Debugger, the histogram results will be displayed in two windows, titled: 


perf Time - Raw Stats and Perf Time - Sorted info. 
2) Timing is ON: 
You may turn timing OFF by selecting the "Performance Timing ..." command, and will get a message in 
the '-Notes-* window that it has been turned off, 
Or you may clear the buckets by holding down the shift key and selecting the "Performance Timing iud 
command. In this case, the next entry to The Debugger wiii generate windows with the names: 


‘perf Time - Raw Stats - 1' and 'Perf Time - Sorted info - 1l. 


Some Details 


When the performance timer is active, the PC is sampled at regular intervals (500 microseconds on Macs 
with 040 CPUs and 1 millisecond on all others), and the value of the appropiate timing 'bucket' is 
incremented. Each bucket covers a 16 byte range. Attempts to increase the sample rate by decreasing the 
interval would increase the time to run the performance analysis as the overhead due to the time manager is 
excessive. Twenty years ago we were able to sample the PC at a rate of 30K samples per second on a 3 
MIPS CPU without disturbing the program. 
Today it is difficult to get 2K samples per second on a 15 MIPS CPU. Such is progress !! 
The amount of memory required for the buckets is : 

(system_heap_size + ROM_size + Zone size of monitored task) divided by 8 ( = 400K or more) 


The space for the buckets is allocated in MultiFinder s heap zone. 


VVhen the Timing analyzer is active, unloading of segments is disabled so that the 'Raw Stats" window 
contains valid addresses. Your program may need more than the normal amount of space to execute. 


Interpreting the Results 


| — ; ---Hits---- 8 ----name-- 

The 'Sorted Info' window lists of the 60 most 15622 29.62% 95.FIND PROC 

frequently executed procedures in descending 3086 5.85% 05.PUSH 

order. An example of it is to the right: 2630 4.98% dë. FIND BLK LIMIT 
| | 2153 4.08% Ә5.МОҸЕВ UP 

The columns are Hits (PC samples in the 2149 4.05% 05.PUSH_LJ 

procedure) the percentage relative to the total 1716 3.25% 05.DECODE_INST 

number of samples, and the name of the procedure 1414 2.68% 05.FIND HOLES 

1277 2.42% 05.SRCH LAB 


preceded by the task number ( ön ). 


The 'Raw Stats' window is a bit more complicated, it contains a header and three sections. One for the task, 
one for ROM and one for the RAM patch area (in the System heap). An example of the window is: 


hz@4FCC30 NosyII 


RAM hits 748 1.41% summary lines 
ROM hits 10158 19.26% 
Task hits 41821 19,31% 


«Task bucket size = 16 
Address--Hits-Offset-Rsrc-Id/Proc 
=04FD190 130 2E 95.LIST HEX 


=04FD1A0 375 d 05.ADDCHAR 
=04FD1BO 84 -4 05.0UT DIG 
=04FD250 T -4 05.UPPEFCASE 


=04FD270 52 IC 
=04FD3A0 41 38 25.5ОВТ 
-ÜAFD3BÜ 52 48 


“0500780 9 -6 05.FIND PROC (current proc name, bucket start - proc-6) 
=0500790 7 A 

=05007A0 9494 1A 

-05007B0 6107 2A ( 6107 samples in the bucket starting at FIND PROC+$2A ) 
=05007C0 4 3A = 

=0501820 1 2 dp. FIND CASE INFO 


«ROM bucket size = 16 
Address--Hits-Offset-Rsrc-Id/Proc 


40800000 507 -4 QO.rDA 5 (1st ROM bucket records samples 
40804BEO 9 8 00.X SwapMMUMode above the task £ below ROM ) 
40804C10 126 38 

4080A2A0 20 A d0.Lv11 intl 

4080A2BÚ 4 1A 


The columns in the window are the address of the bucket, the number of samples in the bucket (16 byte 
address range), the offset from the start of the current procedure, and the name of a procedure or resource. 


To go from the ‘sorted info" window to the proc name in the Raw Stats' window, hilite a ön.procName", 
copy it, switch windows, and Cmd-G to find the info for the procedure in the ‘Raw Stats window. 


To view the source/object code, hilite an address and Cmd-D. If you have a source window, use Cmd-Click to 
switch to the interspersed assembly list view. 

Using the Timing Facility 

Enter The Debugger and set breakpoints at points in your program where you want to turn the timer on and 
off. When you reach the start point, select the "Performance Timing” command to turn the timer on. 


When you reach the stop point, you can view and analyze the results, create text files for later use, etc. 
Remember that the addresses may not be valid at a later time if you have unloaded segments, etc. 


If you are timing MPW Tools, then build a MPW Shell .snt file in Nosy so you see the time spent in the Shell. 


Use the Performance timing facility to find critical procedures in the program. If you insist on fine tuning an 
inferior algorithm (like a bubble sort), then the effect of using the timing facility may be minimal. 

On the other hand, if you use the results to think about the algorithm, then you may end up scrapping it, and 
replacing it with one that is more effective. 


In the sample windows above, I did a timing analysis on the treewalk in Nosy and found that most of the ume 
was spent in a linear search routine. As a quick band-aid, I recoded it in assembly language (all of 10 lines), 
and cut the percentage of time spent in that routine by a factor of 2. A better solution would be to keep the 
table that is being built sorted so that existing binary search routines could be used. 


You should attempt to do timing analysis on the parts of your program that do not do heavy disk activity as 
you may find that a large amount of your time is spent in loops waiting for the SCSI requests to complete. 
An alternative is to move the files you will be accessing to RAM Disk. 
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6/23 Dbgr patch files 


6-23DbgrPtch.PKG 


to 


to 


to 


to 


to 


to 


to 


to 


to 


to 


to 


JOHAN 


CDA1051 


INTRIGUE.DVJ 
KILROY 


D5988 
IRIS 


ORACLE.NTD 
G.CONNELL 
SCREENPLAY 
KODAKEN 
WP.WORKS 
V0419 


D3423 
BEZANSON 
ZULCH.R 
LIFETOUCH 


CDA0425 


ABACUS 
D2213 


IAL 
AUST0427 
COREL 
ANDREW . ENG 
CDA0195 
V0645 
BRINKMANN 
STAT.EASE 
ADOBE.BHAST 


FORETUNE.DVJ 
MADA.LIB 


HOL0146 


SWO159 
FALK 


D2453 


GER. XUU0003 


6/23 Jasik Debugger patch Notes - June 23 


9-July-93 


AppleLink:ITA0036 


Page 2 


To ALL, 


Enclosed is a patch file to The Debugger and a newer version of 
XDbgr Startup. 


A version of CoverTest that works with Think C PROTects is available 
seperately (Link me and request it). 
You will need this version if you are using CoverTest. 


eee The 6/21 patch file had a bug in it relative to the handling of 
ASLM libraries, hence this patch file. 


In addition, I have added the following: 


« add names of static funcs to ThC PROJ if 'ThC Static' flag is ON 
AND source is available 


ə The value $fffDfffD for Bad Zero does NOT work well for 040 Mac's 
so The Debugger now uses $50ff50ff for those Mac's 
This change does NOT apply to Accelerated Mac's 


— — — — ал — — — — — — — — 


TN addition to the changes since 5/24 I have done the following to 
The Debugger: 


« revise handling of ASLM so that one can debug Multi-seg Libraries. 
Also, if resource type to be debugged is NOT = "code", then SYM file name 
must be of the form 'LibraryName.rrrr.SYM' where rrrr is the Resource type. 
Tasks are deleted when all segments are unloaded. 


fix - System hangs when Dbgr, FileShare and ASLM active 


fix ? - make _SystemTask, etc a NO-OP inside The Debugger to 
promote better operation vith AOCE, WorldScript, etc 


fix - add a KLUDGE to display the 1st 9 chars of a '^SignedByte' for C programm 
This is necessary as C doesn't have a well defined String type. 


fix - blowup in Tbl mgr when trying to increase size of NTE ITT (GT Add Used) 


fix - Paste in Find/Change dialog didn't work 
fix - misc step into bug in Dbgr caused garbage display of Trap call window 
fix - limit of one beep when errors in Heap display 


Fixs in the 5/24 package were: 


work with WorldScript II independent of load order. 
Work wih AOCE 


fix - spurrious heap errors when both Heap Check & MMU protection selected 

fix - ThC projects - failure to test for end of procs caused memory to be munge 
fix - allow writes to GhostWindow with MMU protection ON 

fix - Local Vars display - validate current A6 before trying to display Local V 
fix - more than 16K types, then didn't re-read SYM.snt 


To update your version of The Debugger, change the name of 
of the 3/18/93 version of 'The Debugger' to: 


9-July-93 AppleLink:ITA0036 Page 3 


(3/18 Debugger' and dbl-click on the UpdateMaker 
file "6/23 - Dbgr Patch" to create a nev version 
of "The Debugger' (in the 'Dbgr/Nosy files" folder). 


Steve Jasik 
----Users of Think C Reference V2: 


A patch file to create Version 2.0.1 which is compatable 


with The Debugger is available in the 
"Third party Updates:Symantec Solutions:Updates.. 


area of AppleLink. 


9-July-93 AppleLink:ITA0036 
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OBJE 


What is Object Master? 


Object Master is a tool designed for programmers using 
MPW (C, C++, and Pascal), THINK Object Pascal and 
C, Modula 2 - P1, and other programming languages 
on the Macintosh. Object Master greatly increases 
programmer productivity by providing intelligent source 
code editing, object browsing, resource browsing, 
segmentation mapping, and file mapping all in an 
environment tully integrated with the above 
programming languages via Apple Events. 
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Intelligent source code editing 


One example of intelligent source code editing 

is the ability of the Object Master editor to check syntax 
on-the-fly, catching most errors without having to 
compile. As you create your files, a marker list 

is automatically generated and provides easy access 
to all procedures and objects that have been defined 

in the file. 


With Object Master, you can define custom code 
templates that are used to check the consistency 

of your personal coding style. The Object Master editor 
also allows you to assign unique colors and styles 

to procedures, keywords, and templates. Automatic 
indenting is also supported by Object Master. 





PROCEDURE T Application. Cammtti astCernmand , OVERR IDE ; 


MASTER 


Organize your files into a project 


Object Master automatically maintains a database 

of data definitions and procedures. This organization 
of your files provides for fast navigation and structure 
editing. An Object Master project can mix Pascal, C. 
Modula, Rez, and 411 files. For example, a Pascal 
program that calls several C libraries can be edited 
as a single project with Object Master. 


Tree:ScreenShot.pro CR 
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lm HIER 
Class Tree Window provides graphical display and navigation through the 
project's class hierarchy. 


Documentation For TRpptication.Committ astComman 








[Filing Classes Coler Metheds Fields Text find Meeres  -  —"— — 





CommitLastCormmand calls the Commit methed əf the last TCemmand eb ject ereate4. 
This action oemmits that eemmand, making its ection immune te the effects ef the 
Unde menu item. Mac App calls CommitLastCemmand when a pending cemmand will 
affect the desument in such a way that H will no lenger be pessible te unde the 

last oemmand—fer example, before olesging the document, saving H te the disk, or 
restering (reverting) the desument te fts last saved state. You uguali de net 
need te sal this method yourself. 












Code For TApplication.CommitLastCommand 






IF flastCommand (9 MIL THEN 
BEGIN 
IF fLostCommond. fCadDore THEN 
fLastCoaaand . Сова i t; 
IF flastComeend. fFreeOrCoapletion THEM 
Free! fübject(CfLastCoasand 3. 
fLastComsand :* MIL; 





(Ad), AO 
4001С(АО),-(А?) 
$1FC2(A5) 






Y ñastCommand.fFreedaCcomplhetioa THEN 
MOVE AL (44),41 











52 $0034: ORAL 1001С(41),АО 
40038. HOVEAL (0) 40 
LIT Aeptieatisa Eeee seg) el Lë. $0010XA0) DO 


A Documentation Window and a Code Display Window can be linked to a Browser Window to provide automatic access to any 411 documentation for the method 
being edited as well as a disassembled view of the method. 
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Object Master is a tool designed for programmers using 
MPW (C, C++, and Pascal), THINK Object Pasca! and 
C. Modula 2 - P1, and other programming languages 
on the Macintosh. Object Master greatly increases 
programmer productivity by providing intelligent source 
code editing, obiect brovvsing, resource brovvsing, 
segmentation mapping, and file mapping all in an 
environment fully integrated with the above 
programming languages via Apple Events. 











Intelligent source code editing 


One example of intelligent source code editing 

is the ability of the Object Master editor to check syntax 
on-the-fly, catching most errors without having to 
compile. As you create your files, a marker list 

is automatically generated and provides easy access 
to all procedures and objects that have been defined 

in the file. 


With Object Master, you can define custom code 
templates that are used to check the consistency 

of your personal coding style. The Object Master editor 
also allows you to assign unique colors and styles 

to procedures, keywords, and templates. Automatic 
indenting is also supported by Object Master. 


ni — — — 


Documentation For TApplication.CommitlestComman 


Y MASTER 


Organize your files into a project 


Object Master automatically maintains a database 

of data definitions and procedures. This organization 
of your files provides for fast navigation and structure 
editing. An Object Master project can mix Pascal, C, 
Modula, Rez, and 411 files. For example, a Pascal 
program that calls several C libraries can be edited 
as a single project with Object Master. 


Tree:S$crsenShot.pro 


| NHS pages KOL EISE 
Class Tree Window provides graphical display and navigation through the 
profect s class hierarchy. 











PROCEDURE TápptHeation CemmitLastCemmand ; OVERRIDE ; 
Correnitl astCorrenand calls the Cemmit method ef the last TCemmand ebject ereated. 
This eetien commits that cormnand, making its action immune 1e the effects ef the 







Unde menu tem. "ao 466 calls CommitiastCemmand when 4 pending cemmand will 
affect the document in such à way that H wifi na lenger be possible te unde the 
last sermnand-for example, before elesing the deeurnent, saving H te the disk, er 
restering (reverting) the dscurnent te (ts last saved state. You usually de net 
need tə oar! this method yourself. 








dür 
diri 


IN 
RbandonundeC | | pboord, 


IF fUastConnand €? NIL THEN 
BEGIN 






4001С(А0),-(АТ) 
S1FC2CAS) 










Free! (Оој ect fLes tCoaeand »; F fLastCemmand ffreeOnCompietion THEN 
mədən mH $0032:  MOVEAL (aa), al 
$0034 : MOVEA L $001C(A1),A0 
$0038 : MOVEA L (AD) AG 
[ATAppHeatiea.CemeitLastCo| | SOSA CVEB $0010(40),D0 


A Documentation Window and a Code Display Window can be linked to a Browser Window to provide automatic access to any 411 documentation for the method 
being edited as well as a disassembləd view of the method. 
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EUA, an Extended User Area for 
TMON 


by Darin Adler (December 2, 1986) 


These are some ramblings about EUA, an Extended User Area о (һә TMON debugger. 


Which Version? 


The Extended User Area that this document describes is version 685, Source code is available and should 
be distributed with the EUA whenever possible (versions 667 and greater were created with the MPW 
assembler, available from APDAj. EUA—including "discipline" —works well with the Macintosh arid works 
reasonably well with the Macintosh Plus. 

A quick way of determing the EUA version number from within THON is entering Quser ina NUMBER 
windowandlooking al the decimal numberin parentheses. The high word of Nisthe size of the user area. | 
this value is $6000,then you have not used Patch TMON, or PatchT MON was unsuccessful (i.e. you ran it ori 
a witeprotected disk, etc.]. PatchTMON neednot be used on TMON 2.600 or greater, including TMON ZO. 


Howto Installthe Extended User Area 


The extended user area is longer than TMON will nomaliyallow. The userareais over $7000 bytes, long but 
standard TMON allows user areas of $6000 bytes or fewer. Included with the ЕЈА is a program called 
PalchTMON. This will patch a copy of THON, on the same disk, so that it will work with useraress of upto 
$7F00 bytes. This patch should not affect normal use of TMON, and | recommend patching all TMONs 
except the one on your original disk. To use PetchTMON, put a copy of it on the same disk (in the same 
folder] as TMON. Double-click PatchTMON. If an error occurs, PalchTMON will beep once. 

Once the palchis applied, there are twa waysto use the EUA with TMON. Both are documented inthe 
TMON manual. The first wayisto put the EUA onthe disk with TMON and name it "User Area”. When TMON 
installs itself it looks fora file called "User Area”. If there is afile with this name on the same disk as ТМОН, f 
vill load the file in instead of using the builtin user area inside THON itself. The second wayto loadthe EVA, 
is to double-click the EVA icon from the Finder. This will install TMON and load and use the Extended User 
Area. (If you use this second method, the EUA can be given a file name different from "User Area”) 
Remember, however, that once TMON is installed with a particular user area, the machine must be shut down 
before it can be used with a different one. 
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Functions 


EVA provides a number of new functions in the user area window. Some of these new functions are 
Toggle screens, Template, Stack addresses, Stack crawl. Look for labels between 
LINK/UNLK of Ax, Click mouse outside TMON, Windows, Launch, Shut down and Trap 
discipline. The user area window has been divided into three pages, sothel the window will take up less 
room on the screen. The EVA also provides a built-in table with labels for all the low memory globale 
describedin the Aar 1955 Sollie Suppremenl plus many others. 

The Toggle screens function is used Lo choose between the three pages of user area functions. 
Click on this line and press Retum or Enterto cycle through the pages. 

The Template function displays memory dumps iri anice format forafew data structures. Press Fetum 
on the line until the structure that you want appears between curly brackets [either WindowRecord, 
ControlRecord, TERec or ParamBiockj. Then, type the address of a structure that you wish to 
examine. Tofollowa window orcontrol list, press Enter. | 

The Stack addresses function is useful forsearching the stack fora valid address. Press Enter onthe 
line and valid addresses wil be presented, one by one. 

The Stack crawl function is useful for examiningthe cali chan of routines that start with LINK Аб and 
end with UNLK Ap By pressing Enter repeatedly onthe line, the call chain will be traversed. 

Look forlabeis between LINKIUNLK of Axis a function which causes the EUA fo look for labels 
between LINK and UNLK statements of registers other than Ap To switch to a different address register, 
type the number of the register on this line. To use TMON with some FORTH interpreters, it may be usefulto 
switch to register Az. | 

Click mouse outside TMON is anewnameforthe ShowSem function from the original user area. 

Windows is a function that sets up a default arrangment windows that is used the Monitor starts up. Set 
up the windows the way thet you like and then type a number on the line. 0 means thet you want the 
windows configured just as they are when you choosethe function; 1 means that you do not want the USER 
window to be included. These windows will be saved when the user area is saved using TMON's 
configuration button. 

Launch allows you to exit to the Finder or redaunch the application (for another try al debugging}. 
Eitherfunction closes all open files beforelaunching. О launches the Finder, 1 launches whatever is stored 
nthelow+nemory global CurápName. | 

Shut down shuts down the machine. Oresets; 1 unmounts and ejects all volumes before resetting. 

Trap discipline is a parameter-checking front end to the Mac ROM. It is exactly like Trap intercept, 
except that atrapis onlyinterceptedif one of its parameters isinvalid. There is a strict and a lenient version of 
this discipline. The strict version is recommended for writing new programs, while the lenient can be left on 
all the time, to find out about bugs in existing programs. To toggle between the two different levels, press 
Belum alone op this line. 
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New ROM Features and Bugs 


The EUA provides anumber of features that make THON better for use withthe 128K ROMs. 

The trap table built inta TMON is bypassed and anew one, built ntothe EVA is used. AN of the names 
fornewtraps that Apple has documented are providedin the user area [an intemal trap name table is used, 
and built in trap names of TMON are tumed off). 

Trap numbering has been changed. Withthe old ROMs there were 512 traps, numbered $0 to $1FF. 
With the newROMs (and whenever you use this user areal, there are 768 traps, numbered $0to $FF (OS 
traps] and $800 to $9FF {ToolBox traps}. Because of this new trap numbering, all the trap numbers typed 
into the Trap record, Trap (heap check), Trap discipline, Trap checksum, Trap intercept, and 
Trap signal functions are somewhat different. Previously, typing О 1FF wasawayto select al traps. With 
thenew userarea (old ornewROMs), 0 opt or 0 FFF isthe correct way; typing 0 1FF wil select only 
OS traps ($0 to $FF). 

There are a number of new traps available from the new ROMs. In addition, many traps are actually 
vectors used by the ROMs: useful hooks for changing the behavior of the Mac operating system. Apple 
documentation has not described what these are, but Apple "private" equate files have given them names. 


Patches in EUA 


The extended user area performs several patches on TMON for compatibility of TMON with other products 
(usually dueto bugs inthe other products, not in THON). 

One patch fixes an incompatibility with THON and GCC's HyperDrive 20. GCC’s newer software releases 
are modified so that this problem is corrected both by THON and the HyperDrive software. 

Another patch makes the Debugger trap work properly and hendies unimplemented A000 traps 
properly. There is a palchforsomething badthe AppleTalk driver interface code does (it checks the value at 
address $EQ, whichis resen-eaby Motorola and cAangegby ТМОН). 

There is a patch so that TMON will work with free form sound. This patch was necessary because of 
some buggycode in some old versions of the System. 

ТМОН was patched to call the extended user area so that the background screen is the application 
screen and nol just the grey TMON background. In addition, when using EUA, TMON does not restore the 
mouse coordinates from the application. This used to cause the mouse to jump around after a STEP, 
TRACE, GOSUB, or EXIT. 

Another patch causes TMON to recognize embedded procedure names in resources otherthan CODE 
resources (for example, WDEF and CDEF resources}. Acomplete list of which resource types work with 
embedded procedure namesisinthe source code. 

Yet another patch causes TMON to identify addresses pointed to by the dispatch table in all heap 
blocks. Previously, the identification was only done in non+etocatable blocks. 

A, patch keeps TMON from misbehaving when an emplyresource file is open. 

The EUA changes TMON's behavior wth the SysError trap. Standard TMON will intercept all 
SysError traps except for those with DS error codes of 30 and 31 (disk swapping “dialogs. Some 
applications may use the additional DS codes for*dialogs” of their own. The EVA wili oniytrap codes that are 
used for errors (codes between $01 and $ 1E]. 
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New Stuff 


Anumber of things have improved in the EUA since version 665. Forthose who have been using 665, here 
is a partial list of changes. 

Discipline has been improved again, please send me any suggestions you might have about future 
improvements. 

The launch function now resets the stack pointer to Cor StackBase, this makes it work, even after a 
stack sniff er error. 

This version of the EVA works with the THON 68020 interim version, TMON290, available from ICOM, and 
will work in this way on some 68020 Macs, in addition, this version should be compatible with most large 
screens, if vou use it with anew TMON (version 2.614 or greater). 

| have added ability talook for labels between LINK/UNLK instructions of registers other than AB. This 
should be usefulto some folks who use THON with FORTH interpreters. 

The heap scramble function has been improved. if you have had trouble with it inthe past, you may want 
to try using heap scramble again. It now scrambles in fewer cases, and should no longer disturb properly 
written programs. 

A bug thal was present in version between 667 and 683 was fixed. This means that the Windows 
function should work properly again. 


Wish List 
Af exitems that | might want to address inthe future: 


The goal forlenient discipline is to establish a flavor of discipline that only reveals bugs, rather that strange 
idiosyncrasies of working programs. While the original, strict discipline remains useful [especially for working 
on new programs), the new lenient discipline may be suitable to leave on most of the time. Currently, the 
only difference between lenient and strict discipline is the handling of rectangles, Set TrapAddress, and 
the result of GetScrap. In the future, lenient discipline will only complain about illegal parameters, not 
questionable ones. 

Discipline is goingto be extendedto handle a variety of low4evel routines, for example jIODone, as well 
as 4000 traps. — . 

Many functions of the Extended User Area will be standard in afuture debugging product. 


Optional Patch 


TMON was designed to work with the Mac, but it wil work well with the Mac Plus. Unfortunately, the 
low-nemory global that TMON uses to store its status information ($120, otherwise known as MacJmp), (9 
used bythe newROMs for debugger support. Because of this, TMON will work on the Plus, but when you 
openthe TMON icon a second time, ТМОМ will not know that itis alreadyinstalled. A workaround is to patch 
TMON to use the location ФАЕО instead (this is unused by the system, so far]. Simply search forthe bytes 
00000120 in THON and replace them with 000004£0. This will not cause any problems with the 512, and 
will make TMON work better with the Plus. 


Other Information 


EUA is sata product of ICOM Simulations (distributors of THONJ. İt is free of charge. The debugger, TMON, 
is available from ICOM Simulations, (312) 520-4440. The latest version of the EVA is usually avaiable from 
ICOM. The author of EUA can be contacted by U.S. Mail at 2765 Mar Oak Dr Highland Park, IL 60035, or on 
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m GEnie [and sometimes Delphi) with usemame DADLER. 


TMON News 


This is the first TMON newsletter. The purpose of this newsletter is to inform TMON users of news 
regarding the product and to provide answers to frequentiy asked questions. 


WHO IS ICOM SIMULATIONS, INC.? | 

Many TMON users only know of TMQ software, Inc. as the people behind TMON. ICOM Simulations is the new 
distributor and supporter of TMON. In fact, for the most part we are the same people. ICOM Simulations is our 
new name. We also have a new address which is on the bottom of this newsletter. Please use this address for all 
correspondence dealing with TMON. 


WHAT VERSION ARE WE AT? 

Just to confirm another frequently asked question — the current version of TMON is 2.585. There has been only one 
modification recently, and that was only to change some text from TMQ Software to ICOM Simulations, Inc. on the 
menu screen. This by itself did not justify changing the version number. 


WHAT EXTENDED USER AREA? 

Some of you might already have come across a PUBLIC DOMAIN Extended User Area (EUA) on CompuServe, 
Delphi, or elsewhere. To summarize some of its features, 1) the background screen is the application screen, NOT 
the grey TMON background screen, 2) mouse coordinates are not restored from the application with each 
Step/Trace/Gosub, ... so the mouse moves around the way you would expect it to, 3) there is a stack crawl, 4) there 
. isa built in discipline to check parameters to traps, ... and other nice extensions as well. This is a public domain 
user area (with source code), and as such is not supported by ICOM Simulations. However, many may prefer this 
debugging environment over the ones currently supplied with TMON. The latest version of EUA seen at the time of 
this writing is version 685. (Special thanks to Darin Adler for putting it together; Bill Steinberg for putting it on 
CompuServe; and Peter Olson for putting it on Delphi.) We encourage other user areas to be distributed as public 
domain to support your fellow TMON users. 


Debugger ALTERNATIVES. 

Many people have found (һаг Debugger does not work in TMON as it does in MacsBug. The easiest alternative is 
to use the 68000 instruction TRAP #n, where 'n' is 0..15. (TMON uses TRAP #S$F for breakpoints (see p. 22 of the 
manual), but unless you set a breakpoint so that it is in TMON”s table of breakpoints, TRAP #$F will be recognized 
as a TRAP and the program will fall into TMON.) . Debugger DOES work with the Extended User Area mentioned 
above. 


REFRESHING VECTORS WHILE DEBUGGING EXISTING APPLICATIONS. 

Some applications (i.e. MacWrite!) redirect vectors and EXPECTS them redirected in order to run. TMON can be 
configured to automatically refresh these vectors in the configuration section. This can sometimes be a nice thing, 
but sometimes it can cause problems. The solution — sometimes you MUST disable the Vector Refresh option 
when debugging existing applications. (See p. 33 of the manual "Debugging Existing Applications" for more 
information.) 
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About EUA (Extended User Area) 


June 1987 


As many TMON users already know, TMON is an extensible debugger. One of TMON's most 
popular extensions is a public domain user area written by Darin Adler which has become known 
as EUA (Extended User Area). EUA is not a product of ICOM Simulations. Several versions of 
EUA have been available on CompuServe and Delphi. However, due to the popularity of EUA, 
ICOM Simulations is now providing an EUA disk with TMON. 


EUA provides functions which extend the default user area provided with TMON and adds some 
features which take advantage of the new 128K ROMS. In addition, some compatibility problems 


with TMON and the 128K ROMS are resolved by EUA. Complete source code and a 
documentation file to EUA are also included on the EUA disk. 


OTHER PRODUCTS BY /СОМ Simulations: 
Déjà Vu: A Nightmare Comes True 


Winner of Software Publishers’ Association's Best Entertainment Product and Best New World 
awards for 1985, and winner of MacUser Magazine's Best Entertainment Program for 1985. 


This is a state-of-the-art interactive adventure game for the Macintosh developed by ICOM 


Simulations, Inc. TMON was the debugger used during its development. Déjà Vu is a mouse 
driven game which makes full use of the Mac user interface. 


Uninvited 


This is another interactive adventure using the same award winning game system as Déjà Vu: A 
Nightmare Comes True. 


It is the winner of numerous awards, including: MacUser Magazine's Entertainment Product of the 
Year, 1986; Omni Magazine's Best Macintosh Game, 1986; and nominations for the 1986 


Software Publishers’ Association's "Excellence in Software" awards in four categories: Best 
Entertainment, Best Graphics, Best Concept, and Best User Interface. 


Shadowgate 


The latest in the series of interactive adventure games, developed by ICOM Simulations, Inc., and 
using the same award winning game system as Déjà Vu: A Nightmare Comes True and Uninvited. 


Uninvited, Déjà Vu: A Nightmare Comes True, and Shadowgate are being 

marketed by Mindscape Inc. To find out where to purchase them in your area, call 

Mindscape customer service at 1-800-221-9884 (in Illinois, 1-800-942-7315). 
Future products? 


Keep your eyes open for other quality software from ICOM Simulations, Inc. 
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e Works on Both 128K and 512K Versions of the Machine 


e An absolute must for any serious development on the Macintosh.” 
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Programmed by Waldemar Horwat exclusively for TMQ Software, Inc. 


